home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 010a / ds420.zip / DS_USERS.MAN < prev    next >
Text File  |  1991-10-18  |  125KB  |  2,727 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                         DIRECTORY SCANNER (tm) Ver 4.20
  16.  
  17.                            Copyright (c)  1986-1991
  18.                               All Rights Reserved
  19.  
  20.                                       by
  21.  
  22.                                  Nat Martino
  23.  
  24.                                  PO Box 21284
  25.                                Concord, CA 94521
  26.                                 (510) 672-0538
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                         T A B L E   O F   C O N T E N T S
  61.  
  62.           PROGRAM OPTION SELECTIONS . . . . . . . . . . . . . . . .    1
  63.  
  64.           DIRECTORY INDICATOR MOVEMENT  . . . . . . . . . . . . . .    1
  65.              Directory Movement with Arrow Keys . . . . . . . . . .    2
  66.              Linking Directories to Numbers . . . . . . . . . . . .    3
  67.  
  68.           FILE INDICATOR MOVEMENT . . . . . . . . . . . . . . . . .    5
  69.  
  70.           COMMANDS  . . . . . . . . . . . . . . . . . . . . . . . .    6
  71.              Attribute Tagged Files  . . . . [    A     ] . . . . .    6
  72.              Attribute Directory . . . . . . [  ctrl-A  ] . . . . .    7
  73.              Command Entry . . . . . . . . . [ C  alt-C ] . . . . .    7
  74.              Drive Change  . . . . . . . . . [    D     ] . . . . .    8
  75.              Delete Tagged Files . . . . . . [  alt-D   ] . . . . .    9
  76.              Directory Tree Modifications. . [  ctrl-D  ] . . . . .    9
  77.              Edit Indicated File . . . . . . [ E  alt-E ] . . . . .   12
  78.              Edit Defaults . . . . . . . . . [  ctrl-E  ] . . . . .   13
  79.              Find File . . . . . . . . . . . [    F     ] . . . . .   15
  80.              Free Bytes on Other Drive . . . [  alt-F   ] . . . . .   16
  81.              Help Menu . . . . . . . . . . . [    ?     ] . . . . .   17
  82.              Copy Tagged Files . . . . . . . [    K     ] . . . . .   17
  83.              Color Changes . . . . . . . . . [  alt-K   ] . . . . .   18
  84.              List Indicated File . . . . . . [ L  alt-L ] . . . . .   19
  85.              Limits of Program . . . . . . . [  ctrl-L  ] . . . . .   20
  86.              Move Tagged Files . . . . . . . [    M     ] . . . . .   22
  87.              25 43/50 Line Mode Toggle . . . [  alt-M   ] . . . . .   22
  88.              Print Tagged Files  . . . . . . [ P  alt-P ] . . . . .   23
  89.              Rename Indicated File . . . . . [    R     ] . . . . .   24
  90.              Rescan Directory  . . . . . . . [  alt-R   ] . . . . .   24
  91.              Refresh Screen  . . . . . . . . [  ctrl-R  ] . . . . .   24
  92.              Split Screen  . . . . . . . . . [    S     ] . . . . .   25
  93.              Select & Sort . . . . . . . . . [  alt-S   ] . . . . .   25
  94.              Set Mouse Defaults  . . . . . . [  ctrl-S  ] . . . . .   26
  95.              Toggle Tag  . . . . . . . . . . [    T     ] . . . . .   27
  96.              Tag All Files . . . . . . . . . [  alt-T   ] . . . . .   27
  97.              Control Tagging . . . . . . . . [  ctrl-T  ] . . . . .   27
  98.              Untag File  . . . . . . . . . . [    U     ] . . . . .   28
  99.              Untag All Files . . . . . . . . [  alt-U   ] . . . . .   29
  100.              Utility Tree Dump . . . . . . . [  ctrl-U  ] . . . . .   29
  101.              Volumn ID Toggle  . . . . . . . [  ctrl-V  ] . . . . .   29
  102.              eXecute File  . . . . . . . . . [ X  alt-X ] . . . . .   30
  103.              Mouse Toggle  . . . . . . . . . [  ctrl-Z  ] . . . . .   31
  104.              Switch/Flip Screen  . . . . . . [    +     ] . . . . .   31
  105.  
  106.           MACROS  . . . . . . . . . . . . . . . . . . . . . . . . .   32
  107.  
  108.           EXIT PROGRAM . . . . . . . . . . . [    F9    ] . . . . .   36
  109.  
  110.           REDEFINING KEYS . . . . . . . . . . . . . . . . . . . . .   36
  111.  
  112.           LICENSING & REGISTRATION  . . . . . . . . . . . . . . . .   40
  113.  
  114.           WARRANTY & DISCLAIMER . . . . . . . . . . . . . . . . . .   40
  115.  
  116.           APPENDIX A  - MOUSE BUTTON SPECIFICS  . . . . . . . . . .   41
  117.  
  118.  
  119.  
  120.  
  121.                      +-------------------------------------+
  122.          ============|      PROGRAM OPTION SELECTIONS      |===========
  123.                      +-------------------------------------+
  124.  
  125.          KEYBOARD OPERATIONS
  126.  
  127.               The DS program  design philosophy was  to  get  the  most
  128.          done with the  fewest  keystrokes.   With  that  in  mind  the
  129.          program  makes  use  of  many  key  sequences  which  use  the
  130.          "CONTROL" and "ALT"  keys in  combination  with  other  normal
  131.          keys.    A  limited   capability  exists  for  redefining  the
  132.          keystrokes which activate program options should the  user  be
  133.          so inclined.  See the Redefining Keys  section  at the end  of
  134.          the manual.
  135.  
  136.          MOUSE OPERATIONS
  137.  
  138.               The  DS  program can make use of a 2-button mouse in  the
  139.          following  manner.   One button is known as the  ACTION BUTTON
  140.          and the other is known as the OPTION/ESC BUTTON.   By  default
  141.          the ACTION BUTTON is the Left Button and the OPTION/ESC Button
  142.          is  the Right Button but these assignments can be  changed  by
  143.          the user (along with other mouse parameters)  by making use of
  144.          the "Ctrl-S" (Set Mouse) option.
  145.  
  146.               The ACTION BUTTON,  true to its name,  is the button that
  147.          accomplishes  most of the actions within the program.   It  is
  148.          the button used to Tag, Untag, and Execute files, plus scroll,
  149.          change  and enter directories.   It is also the button used to
  150.          select options from menus.
  151.  
  152.               The OPTION/ESC Button is used to activate the popup menus
  153.          which  provide  the user an alternate means of activating  the
  154.          program  options they would normally select via the  keyboard.
  155.          Once an option has been selected the OPTION/ESC Button becomes
  156.          an ESC Button and provides the user a means of terminating the
  157.          option they have selected.
  158.  
  159.               A fuller discription of  Mouse Button  specifics  can  be
  160.          found in Appendix A.
  161.  
  162.                      +-------------------------------------+
  163.          ============|    DIRECTORY INDICATOR MOVEMENT     |===========
  164.                      +-------------------------------------+
  165.  
  166.          USING KEYBOARD:
  167.  
  168.               The Function Keys F1 thru F8 allow the user to  move  the
  169.          directory  highlighter  from one directory to another.  Moving
  170.          the highlighter from directory to directory  does  not  change
  171.          the  user  into the newly highlighted directory until the user
  172.  
  173.  
  174.                                     - 1 - 
  175.  
  176.  
  177.  
  178.          strikes the carriage return [CR] key.  The directory  function
  179.          keys do the following:
  180.  
  181.            F1 - Move  the  directory  highlighter  backward/up  to  the
  182.                  previous directory.
  183.  
  184.            F2 - Move the directory highlighter forward/down to the next
  185.                 directory.
  186.  
  187.            F3 - Move the directory highlighter up the tree display half
  188.                 as many directories as are currently displayed.
  189.  
  190.            F4 - Move the directory highlighter down  the  tree  display
  191.                 half as many directories as are currently displayed.
  192.  
  193.            F5 - Move the directory highlighter to the root directory.
  194.  
  195.            F6 - Move  the  directory   highlighter  to  the  very  last
  196.                 directory.
  197.  
  198.            F7 - Scroll up the display of the directory structure.
  199.  
  200.            F8 - Scroll down the display of the directory structure.
  201.  
  202.                   ************      You  need  to  hit  the
  203.                   * REMEMBER *      carriage return [CR] to
  204.                   ************      change/enter a directory.
  205.  
  206.               If the user is in the split screen mode (see "S"  option)
  207.          the active directory is altered as indicated above with the F1
  208.          thru  F8  and <CR>  keys.  To alter the directory in the  non-
  209.          active display, use the <Ctrl-PgUp>, <Ctrl-PgDn> and <Ctrl-CR>
  210.          keys.
  211.  
  212.               DIRECTORY MOVEMENT WITH ARROW KEYS  -  The  user  has  an
  213.          alternate means of moving the  directory  highlighter  through
  214.          the use of the arrow keys.  Normally the arrow keys  are  used
  215.          to move amongst the files of a directory,  however;  with  the
  216.          help of the space bar acting as a toggle key, the  arrow  keys
  217.          can move the directory highlighter as well.  This can be handy
  218.          for  those users possessing keyboards with function keys along
  219.          the top of the keyboard which makes it difficult  to  use  for
  220.          directory movement.
  221.  
  222.              The SPACE bar is used as a toggle to switch the definition
  223.          of the arrow keys from file movement to directory movement and
  224.          back again.  A small left pointing arrow  will  appear  midway
  225.          down the border between the  directory  screen  and  the  file
  226.          screen  when  the  arrow  keys  work  on  directory  movement.
  227.          When no left arrow appears in the border between the  screens,
  228.          the arrow  keys  work on  file  movement.   Users  that desire
  229.          preventing the SPACE bar from  acting  as a  toggle  key  (and
  230.  
  231.  
  232.                                     - 2 - 
  233.  
  234.  
  235.  
  236.          accidently switching the arrow key definitions)  can lock  out
  237.          the  SPACE  bar toggle feature by   selecting   the   "CTRL-E"
  238.          (edit defaults) option and setting the appropriate default.
  239.  
  240.               LINKING DIRECTORIES TO NUMBERS OPTION - The user may link
  241.          a directory to a number (1 thru 9) or alt-number  (alt-1  thru
  242.          alt-9)   key  sequence.   After  a  directory  is  so  linked,
  243.          selecting the number or alt-number sequence will highlight the
  244.          desired directory.  To enter the directory the user may  still
  245.          be required to hit the return/enter key.
  246.  
  247.               The user may display and/or change directory-number links
  248.          by selecting the "0" key or "alt-0" key sequence.  The display
  249.          presented  will allow changes to the links by highlighting the
  250.          desired directory with F1 thru F8,  the  desired  number  with
  251.          Up/Dn Arrows,  and then using the Ins key to assign a link, or
  252.          the Del key to delete a link.  If changes are made,  the  user
  253.          is  prompted to chose whether the startup defaults file should
  254.          be permanently modified.  Also from this display the user  may
  255.          elect  to  switch  directly  to  another  displayed  directory
  256.          without making any changes to displayed links.
  257.  
  258.               When  using  the  directory   link   option   to   switch
  259.          highlighted  directories  the  drive  id  of  the  source  and
  260.          destination directories is significant.  If the  drive  id  of
  261.          the   source  or  current  directory  is  different  from  the
  262.          destination or future directory  then  not  only  is  the  new
  263.          directory  highlighted  but the user is also placed in the new
  264.          directory and presented with the listing of files in that  new
  265.          directory  on  the right side of the display.  If the drive id
  266.          of the source and  destination  are  the  same  then  the  new
  267.          directory  is  highlighted  but  the  user  remains in the old
  268.          directory and the file  listing  on  the  right  side  of  the
  269.          display  remains  unchanged.  To  enter  the  new  directory a
  270.          return/enter must be entered.
  271.  
  272.               "TAB <ltr>" OPTION - Depressing the TAB key  followed  by
  273.          a letter  will move the  highlighted  directory  to  the first
  274.          directory whose first letter of its full  pathname  (excluding
  275.          drive id, ie: "c:\") is equal to or greater than the specified
  276.          letter.
  277.  
  278.          USING MOUSE:
  279.  
  280.               To "ENTER"  a directory "release" the Action Button while
  281.          the mouse is on top of the directory NAME.
  282.  
  283.               To "HIGHLIGHT BUT NOT ENTER"  a  directory "release"  the
  284.          Action Button while the mouse is on the directory line but not
  285.          on top of the directory name.
  286.  
  287.               To  Scroll  Up the directory tree keep the Action  Button
  288.  
  289.  
  290.                                     - 3 - 
  291.  
  292.  
  293.  
  294.          depressed while the mouse is in the Upper Left Screen  Border.
  295.          The  scrolling speed can be user controlled.   Depressing  the
  296.          "CONTROL"  key  while the mouse is in the  Upper  Left  Screen
  297.          Border will display a "Delay" value.  Depressing the "ALT" key
  298.          will  reduce  the  "Delay"  value and thereby  accelerate  the
  299.          scrolling  speed.    Depressing  the  "LEFT  SHIFT"  key  will
  300.          increase the delay value and thereby slow the scrolling speed.
  301.          Once  the desired scrolling speed is obtained the user  should
  302.          press the "CONTROL"  and "RIGHT SHIFT" keys together to record
  303.          the scroll speed as a startup default parameter.
  304.  
  305.               To Scroll Down the directory tree keep the Action  Button
  306.          depressed while the mouse is in the Lower Left Screen  Border.
  307.          The scrolling speed can be adjusted in this area as  it was in
  308.          the previous paragraph.
  309.  
  310.               To Highlight the Root directory click the  Action  Button
  311.          while the mouse is on the  topmost row  of the  Center Divider
  312.          between the Directory Box and the File Box.
  313.  
  314.               To Highlight the Last directory click the  Action  Button
  315.          while the mouse is on  the  bottom  most  row  of  the  Center
  316.          Divider between the Directory Box and the File Box.
  317.  
  318.               To Page Up the directory tree  click  the  Action  Button
  319.          while the mouse is in the Upper  Center  Divider  between  the
  320.          Directory Box and the File Box.
  321.  
  322.               To Page Down the directory tree click the  Action  Button
  323.          while the mouse is in the Lower  Center  Divider  between  the
  324.          Directory Box and the File Box.
  325.  
  326.               When one of the  Directory  Link  Lists  (0 or Alt-0)  is
  327.          displayed, clicking the action button in the  following  areas
  328.          will invoke the following appropriate responses:
  329.  
  330.             Left of "=" sign  -  Move highlighter to this number link.
  331.  
  332.             On the "=" sign  -  Move highlighter  to  this  number link
  333.                           and "delete" (unlink) any assigned  directory
  334.                           from this number key.
  335.  
  336.             Right of "=" sign  -  Move highlighter to this number  link
  337.                           and "insert" (link) the highlighted directory
  338.                           to this number key.
  339.  
  340.             Right Border of "File Box"  -  Page back and forth from the
  341.                           "0"  Directory  Link  List  to   the  "Alt-0"
  342.                           Directory Link List.
  343.  
  344.  
  345.  
  346.  
  347.  
  348.                                     - 4 - 
  349.  
  350.  
  351.  
  352.                          +---------------------------+
  353.          ================|  FILE INDICATOR MOVEMENT  |=================
  354.                          +---------------------------+
  355.  
  356.               Upon  entering  a  directory  that  contains  one or more
  357.          files,  the first file in the directory is marked with 2 small
  358.          triangluar  indicators,  one  on  each  side of the file name.
  359.          This indicates which file is the current "indicated file", and
  360.          further file information about this file is displayed  at  the
  361.          bottom of the display screen.
  362.  
  363.          USING KEYBOARD:
  364.  
  365.               To  change  the  "indicated file" the file indicators are
  366.          moved from file to file through the use of  the  cursor  arrow
  367.          keys  on  the numeric keypad.  The arrow and related keys work
  368.          as follows:
  369.  
  370.             Up Arrow Key    - Move to the previous file
  371.  
  372.             Down Arrow Key  - Move to the next file
  373.  
  374.             Left Arrow Key  - Move to the file in  the  column  to  the
  375.                               left
  376.  
  377.             Right Arrow Key - Move to the file in  the  column  to  the
  378.                               right
  379.  
  380.             Home Key        - Move to the first  file  on  the  display
  381.                               screen
  382.  
  383.             End Key         - Move to the  last  file  on  the  display
  384.                               screen
  385.  
  386.             PgUp Key        - Display previous page of file names
  387.  
  388.             PgDn Key        - Display next page of file names
  389.  
  390.               The  PgUp/PgDn  keys  are  active only when the currently
  391.          displayed directory has more files than can fit  on  a  single
  392.          screen/page.
  393.  
  394.            "TAB TAB <ltr>" OPTION -    Depressing  the  TAB  key  twice
  395.          followed by a letter will change the "indicated file"   to  be
  396.          the  first file whose first letter of its name is equal to  or
  397.          greater than the specified letter.
  398.  
  399.          USING MOUSE:
  400.  
  401.               To change the indicated file with the mouse  simply  move
  402.          the mouse over the name of the  desired  file  and  click  the
  403.          Action Button.  This action will toggle the Tag status of  the
  404.  
  405.  
  406.                                     - 5 - 
  407.  
  408.  
  409.  
  410.          desired file from untagged to tagged or  vice versa.   If  you
  411.          desire to leave the tag  status as  it was  before,  click the
  412.          Action Button on the file name a second time.
  413.  
  414.               To "Page" to the next or previous "pages" of listed files
  415.          click the Action Button while the mouse is  in  the  Upper  or
  416.          Lower Right Screen Border.  An "up arrow" will appear  in  the
  417.          Upper Right Screen Border if there are previous pages of files
  418.          to list.  A "down arrow" will appear in the Lower Right Screen
  419.          Border if there are following pages of files to list.
  420.  
  421.                          +---------------------------+
  422.          ================|         COMMANDS          |=================
  423.                          +---------------------------+
  424.               +-----------------------------+         +----------+
  425.          -----|   ATTRIBUTE TAGGED FILES    |---------|   "A"    |-----
  426.               +-----------------------------+         +----------+
  427.  
  428.          USING KEYBOARD:
  429.  
  430.               This option allows the user to change 4 of the  attribute
  431.          bits  on  all  files  that are tagged.  Depressing "A" with no
  432.          files tagged will allow the user to work only on  the  current
  433.          indicated file.  Activation of  this  option  will  allow  the
  434.          user  to turn on/off the read-only bit,   the system bit,  the
  435.          hidden  bit and the archive bit  by  toggling the   "r",  "s",
  436.          "h"  and "a" keys respectively.  Changing the file's attribute
  437.          bits   only  takes effect when the "M"   key (for  Modify)  is
  438.          depressed.   The  user should toggle the attribute select keys
  439.          ("r",  "s", "h" & "a")   to the desired states,   then hit the
  440.          "m" key to  activate the desired changes.
  441.  
  442.               This  option  will also allow the user to  tag  or  untag
  443.          certain  files  based on the current status of  the  attribute
  444.          bits.   The user should set/specify the desired attribute bits
  445.          to  test  each file,   then select <CTRL-T>  or  <CTRL-U>  for
  446.          tagging or untagging based on the specified bits.  The <SPACE>
  447.          bar  can be used to toggle the logical AND/OR condition  which
  448.          applies to this control tagging option.
  449.  
  450.               The option will also allow the use of <Alt-T> and <Alt-U>
  451.          for tagging or untagging all files.  Additionally single  file
  452.          tagging or untagging is allowed with the "T" and "U" keys.
  453.  
  454.          USING MOUSE:
  455.  
  456.               All  the  file  attribute  options  remain  the  same  as
  457.          discussed above.  To select and/or change  the  options  using
  458.          the mouse simply click the Action Button while the mouse is on
  459.          top of the desired option.
  460.  
  461.  
  462.  
  463.  
  464.                                     - 6 - 
  465.  
  466.  
  467.  
  468.               +-----------------------------+         +----------+
  469.          -----|     ATTRIBUTE DIRECTORY     |---------| "Ctrl-A" |-----
  470.               +-----------------------------+         +----------+
  471.  
  472.               This option allows the user to change  the  same  4  file
  473.          attribute  bits  that  Option  A (above) changes,  except this
  474.          option  works  on  the  attribute  bits  of  the   highlighted
  475.          directory.   The  significance  of  changing  the   read-only,
  476.          system,  and archive bits of a directory is unknown.   Turning
  477.          the  hidden bit of a directory on will hide the directory from
  478.          the normal  DOS "dir"   command.   The   DS  program  can  see
  479.          the   directory regardless of the condition of the hidden bit.
  480.          The   user   may want  to  hide  a  directory  so  that  other
  481.          people that use the same machine do not  rummage  through  the
  482.          hidden   directory.   This assumes the other users do not know
  483.          or  have  access  to the DS or other programs  that  show  the
  484.          directory  regardless  of the hidden   bit.    The   user   is
  485.          prohibited   from   changing  the attribute bits on  the  root
  486.          directory  of  any  drive.   All  sub-directories   are   fair
  487.          game.
  488.  
  489.               Upon  selecting this option,  the attribute bit  settings
  490.          show the current status of the highlighted directory. The user
  491.          can  use  the F1  thru F8   keys to show the bits settings  on
  492.          other directories.
  493.  
  494.               +-----------------------------+       +------------+
  495.          -----|        COMMAND ENTER        |-------|"C"  "Alt-C"|-----
  496.               +-----------------------------+       +------------+
  497.  
  498.          USING KEYBOARD:
  499.  
  500.              The  command  entry  option  allows  the user to enter any
  501.          command they would enter at the  normal  DOS  command  prompt.
  502.          Whatever  is entered by the user is passed on to a second copy
  503.          of "command.com".   Upon depressing the "c" or "alt-c" key the
  504.          bottom 3 lines of the display screen will be cleared  and  the
  505.          following message appear:
  506.  
  507.                 To return to DS - Enter only a carriage return
  508.  
  509.          The DOS command line prompt will be the current path  followed
  510.          by a triangle symbol pointing to the right.   Users may  enter
  511.          as many commands in sequence as they desire,  returning  to DS
  512.          by entering only a carriage return.   This option  will  allow
  513.          the user to interface with DOS command stack programs such  as
  514.          "CED", and with DOS  keyboard  enhancement  programs  such  as
  515.          "Newkey".
  516.  
  517.               The "c" option will process one  or more  commands  while
  518.          the DS program stays resident in  memory.   The "alt-c" option
  519.          will process the desired  command  while  overlaying  the   DS
  520.  
  521.  
  522.                                     - 7 - 
  523.  
  524.  
  525.  
  526.          program.  Upon  termination  of  the  "alt-c"  option  the  DS
  527.          program will be reloaded from disk.   The  "alt-c"  option  is
  528.          slower to reload/restart DS but useful  in  systems  that  are
  529.          tight on memory.  Upon reloading DS the "alt-c"  option should
  530.          retain the same current "indicated file"; however, all tagging
  531.          of files will be lost.
  532.  
  533.               The edit defaults option ("Ctrl-E")  contains a selection
  534.          item  that will instruct the program to automatically use  the
  535.          "alt-c"  option  even if the "c"  option  was selected if  the
  536.          amount  of  available memory is less than a  specified  value.
  537.          The specified amount of memory is user tunable. Selecting 590k
  538.          for the memory limit will force the program to always use  the
  539.          overlay option.  Selecting  10k  for  the  memory  limit  will
  540.          prevent the overlay option from being used  in  place  of  the
  541.          normal option.
  542.  
  543.          USING MOUSE:
  544.  
  545.               Click the OPTION/ESC Button to bring up  the  popup  menu
  546.          then click the Action Button on the appropriate  suboption  on
  547.          the DOS submenu.
  548.  
  549.               +-----------------------------+         +----------+
  550.          -----|        DRIVE CHANGE         |---------|   "D"    |-----
  551.               +-----------------------------+         +----------+
  552.  
  553.              The  drive  change  option  allows the user to switch to a
  554.          different default drive and display  the  directory  structure
  555.          information of the new drive.  When switching off a hard disk,
  556.          all directory structure information about that drive and other
  557.          pertinent  program  information (ie:  current colors) is first
  558.          copied to the "ds_globl.log" and  "ds_drv_?.log"  files.  This
  559.          is done so that when switching back to that hard  disk  it  is
  560.          not necessary to do a rescan of the entire disk to recover the
  561.          disk directory structure information.  The  user  can  specify
  562.          which drives the program will maintain "log"  files on through
  563.          the use of the "Ctrl-E" option.
  564.  
  565.              This option will also  allow  the  user  to  change  to  a
  566.          different log file of the same or  different  drive.  Once the
  567.          user presses "d" to activate this option they may  then  enter
  568.          up to 4 characters for the  specified  destination  drive.  If
  569.          the user specifies the destination drive of "c", they will  be
  570.          switched to the C: drive using  the  "ds_drv_c.log"  (default)
  571.          log file.  If the user  specifies  the  destination  drive  of
  572.          "c123", they will be  switched  to  the  C:  drive  using  the
  573.          "ds_drv_c.123" log file.  Note that neither a ":"  nor  a  "."
  574.          is used.  If the user switches to a drive via a log file other
  575.          than the  default  (".log")  then  the  default  log  file  is
  576.          overwritten by the specified log file so that it  becomes  the
  577.          current default log.
  578.  
  579.  
  580.                                     - 8 - 
  581.  
  582.  
  583.  
  584.  
  585.          USING KEYBOARD:
  586.  
  587.               Depress the "d"  key  then  depress  the  letter  of  the
  588.          destination drive.
  589.  
  590.          USING MOUSE:
  591.  
  592.               To change drives using  the  mouse  from  the  main  menu
  593.          simply click the Action Button on one of the  Available  Drive
  594.          letters located in the Top Left Screen Border.
  595.  
  596.               +-----------------------------+         +----------+
  597.          -----|     DELETE TAGGED FILES     |---------| "Alt-D"  |-----
  598.               +-----------------------------+         +----------+
  599.  
  600.              The  delete  tagged  files  option  will allow the user to
  601.          delete those files that  have  been  tagged  (see  Option  "T"
  602.          below).  This  option  will  first request a confirmation that
  603.          the user really wants to delete all those  files  marked.  THE
  604.          DEFAULT  CONFIRMATION  RESPONSE IS "Y",  SO DEPRESSING ANY KEY
  605.          EXCEPT "N" (and ESC) WILL DELETE ALL TAGGED FILES.
  606.  
  607.          USING KEYBOARD:
  608.  
  609.               Tag the desired tiles, depress the  "ALT"  and  "d"  keys
  610.          together, then depress the <CR> key to confirm deletion.
  611.  
  612.          USING MOUSE:
  613.  
  614.               Tag the desired files, click  the  OPTION/ESC  Button  to
  615.          display the popup menu, then select the  Delete  suboption  on
  616.          the FILE submenu with the Action Button.   A  confirmation  is
  617.          not required when using the mouse.
  618.  
  619.  
  620.  
  621.               +-----------------------------+         +----------+
  622.          -----| DIRECTORY TREE MODIFICATION |---------| "Ctrl-D" |-----
  623.               +-----------------------------+         +----------+
  624.  
  625.              The  directory  modification option will allow the user to
  626.          add/delete  directories  and  change  the  name  of  specified
  627.          directories.  Additionally, this option will enable  the  user
  628.          to  modify  the  tree   display  without  adding  or  deleting
  629.          directories on the hard disk, and to save to or read from disk
  630.          "log" files of  the  specified  drives.  Once  the  option  is
  631.          selected, the 7 sub-options are displayed.
  632.  
  633.             Add Directory - This option will create a new directory  on
  634.                the hard disk and modify the tree display to include the
  635.                new directory.
  636.  
  637.  
  638.                                     - 9 - 
  639.  
  640.  
  641.  
  642.  
  643.                1. The user  must  highlight  (using F1-F8)  the  PARENT
  644.                   directory where the  new  directory  will  be  added,
  645.                   press the "a" key, and then enter the name of the new
  646.                   directory.
  647.                2. The  addition  is  denied  if  the current  number of
  648.                   directories is already at the max directory limit.
  649.                3. The new directory name must be  valid.
  650.                4. The new directory name must have a full pathname less
  651.                   than 64 characters and a screen print name less  than
  652.                   40 characters.
  653.  
  654.             Delete Directory - This option will  delete  the  specified
  655.                directory from both the hard disk and the tree  display.
  656.  
  657.                1. The user must highlight (using F1-F8)  the  directory
  658.                   which they desire to delete and then  press  the  "d"
  659.                   key.
  660.                2. Deletion  is  denied if  the user is currently in the
  661.                   specified directory  (ie:  right  side  file  display
  662.                   matches left side highlighted directory).
  663.                3. Deletion  is  denied if  the highlighted directory is
  664.                   not empty (ie:  has  subdirectories  or  files  still
  665.                   attached).
  666.                4. Deletion  is  denied if  the highlighted directory is
  667.                   the root directory.
  668.  
  669.             Change Name - This option will allow the user to change the
  670.                name of a directory on  both  the  hard  disk  and  tree
  671.                display.
  672.  
  673.                1. The user must highlight (using F1-F8)  the  directory
  674.                   which they desire to change, press the "c"  key,  and
  675.                   then enter the new directory name.
  676.                2. The new directory name must be valid.
  677.                3. The new directory name must have a full pathname less
  678.                   than 64 characters and a screen print name  less than
  679.                   40 characters.  Additionally, the  subdirectories  of
  680.                   the  directory  in  question must not exceed  the  64
  681.                   character pathname as a result of this name change.
  682.                4. The change name option only works on PC/MS DOS  3.0+.
  683.                   DOS 2.x does not support changing of directory names.
  684.  
  685.             Unmount Subdirectories - This option will allow the user to
  686.                delete  subdirectories   on  the  tree  display  without
  687.                deleting them from the hard disk.
  688.  
  689.                1. The user must highlight (using F1-F8)  the  directory
  690.                   which they desire to delete, then press the "u"  key.
  691.                2. The root directory cannot be unmounted.
  692.  
  693.  
  694.  
  695.  
  696.                                     - 10 - 
  697.  
  698.  
  699.  
  700.             Mount Subdirectories - This option will allow the  user  to
  701.                add to the tree display subdirectories which are already
  702.                present on the hard disk.
  703.  
  704.                1. The user  must  highlight  (using F1-F8)  the  PARENT
  705.                   directory of the new subdirectories, then  press  the
  706.                   "m" key.
  707.  
  708.             Write Log File - This option will allow the user  to  write
  709.                out to disk a "log" file of the  current  drive  as  the
  710.                current tree display represents.
  711.  
  712.                1. The user  need only press the "w" key and then  enter
  713.                   the 3 letter filename extension for the file.
  714.                2. The user should not specify a filename  extension  of
  715.                   "log" as the  program  uses  that  extension  as  the
  716.                   default log file for the specified drive.
  717.                3. Note that the user can only specify 3 characters  for
  718.                   the filename extension and that  the "."  is  already
  719.                   provided by the program.
  720.                4. This write option will not only write a new log  file
  721.                   out to disk but also cause a  "switch"  to  that  new
  722.                   log file.  The ".ext" will change in the  top  border
  723.                   after the drive identifier to indicate such a switch.
  724.  
  725.             Switch Log File - This option will allow the user to switch
  726.                to a different "log" file of the current drive which may
  727.                radically change the current tree display.
  728.  
  729.                1. The user  need only press the "s" key and then  enter
  730.                   the 3 letter filename extension for the file.
  731.                2. Note that the user can only specify 3 characters  for
  732.                   the filename extension and that the  "."  is  already
  733.                   provided by the program.
  734.  
  735.             Log Filename Format = ds_drv_X.YYY
  736.                   where  X = letter "a" thru "z" indicating which drive
  737.                              this log file represents.
  738.                        YYY = "log" - default log file for this drive
  739.                          or
  740.                            = "any other valid 3 char"  - a  special log
  741.                              file for the specified drive  created  and
  742.                              maintained by the user.
  743.  
  744.             Log File Rules:
  745.                1. The "ds_drv_X.log" file is  always  the  current  and
  746.                   default log file for specified  drive X.  (X = letter
  747.                   "a" thru "z")
  748.                2. When exiting the Directory Mod (ctrl-d)  routine  the
  749.                   ".log" file for the current  drive  is  automatically
  750.                   updated on the disk to reflect the current  displayed
  751.                   directory tree.
  752.  
  753.  
  754.                                     - 11 - 
  755.  
  756.  
  757.  
  758.                3. When exiting the Directory  Mod  (ctrl-d)  routine  a
  759.                   drive log file with an extension other than ".log" is
  760.                   updated automatically if the extension  is  shown  in
  761.                   the top border after the drive identifier.
  762.                4. If drive X has  2  log  files  (extensions  ".log"  &
  763.                   ".123") and the user currently on drive Y  wishes  to
  764.                   return to drive X, they may  specify  either  of  the
  765.                   following to the Drive Change ("d") command:
  766.                      a) "X" - to change to drive X using ".log" as  the
  767.                         drive log.
  768.                      b) "X123" - to change to drive X using  ".123"  as
  769.                         the drive log.  This input will result  in  the
  770.                         ".log" file being written over  by  the  ".123"
  771.                         file.
  772.  
  773.             Upon  completion  of any of the above  options the  program
  774.          will  make necessary adjustments to the directory tree display
  775.          and  allow the  user  to  make  additional modifications.   To
  776.          terminate the directory  modification option, hit the ESC key.
  777.          Upon terminating this  option  with  with  the  ESC  key,  the
  778.          program automatically updates the current drive's ".log"  file
  779.          to reflect the current tree display.
  780.  
  781.          USING KEYBOARD:
  782.  
  783.               Depress the "CONTROL" and "d" keys together,  then select
  784.          the desired suboption by depressing the appropriate  suboption
  785.          selection key.
  786.  
  787.          USING MOUSE:
  788.  
  789.               Click the OPTION/ESC Button to bring up  the  popup  menu
  790.          then select the appropriate suboption  on  the  TREE  submenu.
  791.          All the directory mod options  work as  discused  in  previous
  792.          paragraphs, simply select the appropriate option  by  clicking
  793.          the Action Button while the mouse is on  top  of  the  desired
  794.          option.
  795.  
  796.               +-----------------------------+       +------------+
  797.          -----|     EDIT INDICATED FILE     |-------|"E"  "Alt-E"|-----
  798.               +-----------------------------+       +------------+
  799.  
  800.              The  edit  option  will allow the user to edit the current
  801.          "indicated file".  The  user  must  supply  and  identify  the
  802.          desired  editor  to  the  DS program.  The DS program does not
  803.          provide an editor of its own, but simply attempts to execute a
  804.          ".com" or ".exe" file that has been defined  by  the  "Ctrl-E"
  805.          option  as the default editor.  The user should specify a full
  806.          pathname for the desired editor with the "Ctrl-E"  option.  If
  807.          the user has not previously defined their own favorite  editor
  808.          to  the  DS  program,  the program  will attempt to execute  a
  809.          file by the name of  "edit.com",  "edit.exe",  or  "edit.bat".
  810.  
  811.  
  812.                                     - 12 - 
  813.  
  814.  
  815.  
  816.          Upon  successful  execution  of  the  defined  editor,  the DS
  817.          program passes to it  the name  of the current indicated file.
  818.          Upon  termination  of  the  editing  process,  the  DS program
  819.          resumes where it left off.
  820.  
  821.               The "e" option will edit the indicated file while  the DS
  822.          program stays resident in  memory.   The  "alt-e"  option will
  823.          edit the indicated file while overlaying the DS program.  Upon
  824.          termination of the  "alt-e"  option the  DS  program  will  be
  825.          reloaded from disk.  The  "alt-e"  option is  slower to reload
  826.          or restart DS but useful in systems that are tight on  memory.
  827.          Upon reloading DS the  "alt-e"  option should  retain the same
  828.          current "indicated file";  however, all tagging of files  will
  829.          be lost.
  830.  
  831.               The edit defaults option ("Ctrl-E")  contains a selection
  832.          item  that will instruct the program to automatically use  the
  833.          "alt-e"  option  even if the "e"  option  was selected if  the
  834.          amount  of  available memory is less than a  specified  value.
  835.          The specified amount of memory is user tunable. Selecting 590k
  836.          for the memory limit will force the program to always use  the
  837.          overlay option.  Selecting  10k  for  the  memory  limit  will
  838.          prevent the overlay option from being used  in  place  of  the
  839.          normal option.
  840.  
  841.               It  is  highly  recommended  that  the  user  obtain  and
  842.          execute the  "DPATH"  program  (found  on  most  RBBS  boards)
  843.          in   their autoexec.bat  file.  DPATH  is  to  data files what
  844.          PATH is to executable files. With DPATH in effect, your editor
  845.          will  be able  to  find  supporting  files  even  though  your
  846.          current  directory may not be  the directory where your editor
  847.          and the support files reside.  Users who have DOS 3.2 or later
  848.          should use the  "APPEND"  command which accomplishes the  same
  849.          results as the DPATH program.
  850.  
  851.          USING KEYBOARD:
  852.  
  853.               Depress the "e" key when  the  "current file"  indicators
  854.          are on both sides of the desired file.
  855.  
  856.          USING MOUSE:
  857.  
  858.               Click the OPTION/ESC Button to bring  up the  popup  menu
  859.          then select the appropriate suboption on the FILE  submenu  by
  860.          clicking on it with the Action Button.
  861.  
  862.               +-----------------------------+         +----------+
  863.          -----|        EDIT DEFAULTS        |---------| "Ctrl-E" |-----
  864.               +-----------------------------+         +----------+
  865.  
  866.              The  Edit  Defaults   option will  allow   the   user   to
  867.          define 6 default parameters.  The user can specify the default
  868.  
  869.  
  870.                                     - 13 - 
  871.  
  872.  
  873.  
  874.          editor (depressing the "E" key), the default lister ("L" key),
  875.          and  the  default  print  ("P"  key)  programs.   The  initial
  876.          defaults  for the editor,   lister,  and  printer  are "edit",
  877.          "list",  and "print",   but may be  changed by the user.  Upon
  878.          selection of this option the user is presented with a  display
  879.          of  the  current  defaults and the  command  keys  to   effect
  880.          changes. The user should specify A COMPLETE PATHNAME  for  the
  881.          desired editor, lister, and print programs.  For example,   if
  882.          the desired editor is "list.com" in the "dos" directory on the
  883.          "c:"   drive,  then specify "c:\dos\list"   rather  than  just
  884.          "list".   Failure to  specify a complete pathname will  result
  885.          in  the  "alt-e",  "alt-l",  and "alt-p"  options failing   to
  886.          execute  and   presenting   the following (rather  misleading)
  887.          DOS error message:
  888.  
  889.                          "run-time error R6005
  890.                           -not enough memory on exec"
  891.  
  892.              This  option  will also allow the user  to  specify  which
  893.          drives  the program will maintain "log"  files.  Log files are
  894.          maintained  on hard disks so the program will not  rescan  the
  895.          entire  disk  each time on startup to determine the  directory
  896.          structure information.
  897.  
  898.              This option will additionally allow the user to specify an
  899.          amount  of  memory  whereupon the program  will  automatically
  900.          switch from using the "e",  "l", "x", "c"  and "p"  options to
  901.          using  the  respective overlay versions of the  same  options.
  902.          Editing  these  memory  amounts is accomplished  by  selecting
  903.          either an upper or lower case "e", "l", "x", "c", or "p".  For
  904.          example,  to decrease the specified memory amount for the  "c"
  905.          option,  depress  the  lowercase  "c"  key.  To  increase  the
  906.          specified memory for the "c" option, depress the uppercase "C"
  907.          key.
  908.  
  909.              The final default which this option can set is whether the
  910.          space  bar will toggle the use of the arrow keys between  file
  911.          and  directory  movement.   Use the space bar  to  toggle  the
  912.          default parameter settings.
  913.  
  914.          USING KEYBOARD:
  915.  
  916.               Depress the "CONTROL" and "e" keys together.   Use the up
  917.          and down arrows to select the desired option to modify.
  918.  
  919.          USING MOUSE:
  920.  
  921.               Click the OPTION/ESC Button to bring up  the  popup  menu
  922.          then select the "Defaults" suboption on the SETUP  submenu  by
  923.          clicking on it with the Action Button.
  924.  
  925.  
  926.  
  927.  
  928.                                     - 14 - 
  929.  
  930.  
  931.  
  932.               +-----------------------------+         +----------+
  933.          -----|          FIND FILE          |---------|   "F"    |-----
  934.               +-----------------------------+         +----------+
  935.  
  936.             The find option will allow the user to search  the  current
  937.          default  drive  for  a  specified file.  The user provides the
  938.          name of the file,  which can include the "*" and "?"  wildcard
  939.          specifiers.  The  find  option  will then commence a search of
  940.          all directories starting  from  the  root  directory.  When  a
  941.          matching  file  is found in a directory,  the program stops in
  942.          that directory and DISPLAYS ONLY THOSE FILES OF THE  DIRECTORY
  943.          THAT  MATCH THE SPECIFIED STRING.  This option only stops once
  944.          in each directory.  Any additional files that match (which  is
  945.          likely with "*" and "?") will also be displayed along with the
  946.          "indicated file".
  947.  
  948.             Once the program has halted  in  a  directory  that  has  a
  949.          matching file the following options are available:
  950.  
  951.              Arrow Keys   \
  952.              Home / End    }  -   Work as they normally do
  953.              PgUp / PgDn  /
  954.  
  955.              'L' or 'l' Key   -   Will list the indicated file
  956.  
  957.              Note: Directory movement keys F1-F8 do not work here.
  958.  
  959.          The user has 3 additional options to continue/terminate:
  960.  
  961.              F2  Key   -  Continue searching directories.
  962.  
  963.              [CR] Key  -  Terminate  search  option  in  the  currently
  964.                           displayed directory.
  965.  
  966.              ESC Key   -  Terminate search option & return user to  the
  967.                           original directory from which the option  was
  968.                           started.
  969.  
  970.          If "F2" is chosen,  upon completion of the final directory the
  971.          user is placed in the original directory from which  the  find
  972.          option was activated.
  973.  
  974.          Note:  The  find option disregards the user's current select &
  975.          sort options (see ALT-S) while searching for  matching  files.
  976.          During  execution,  the  find option uses a select criteria of
  977.          the specified search  string  and  sorts  files  by  ascending
  978.          filename.  Therefore,  display  of  directories  which contain
  979.          matching files will show  only  those  filenames  of  matching
  980.          files  even  though  there  may  be  additional  files  in the
  981.          directory.   Upon  termination  of  this  option,  the  user's
  982.          original  select & sort options are reinstated.  If,  however,
  983.          the user exits this option through the use of the CR  (current
  984.  
  985.  
  986.                                     - 15 - 
  987.  
  988.  
  989.  
  990.          directory) key,  there is the possibility that  the  file  the
  991.          user  just  found  will  disappear if the original file select
  992.          criteria does not match the file just found.  Confusing  isn't
  993.          it.
  994.  
  995.          USING KEYBOARD:
  996.  
  997.               Depress the "f"  key,  enter  the  desired  filename  for
  998.          searching, then depress the <CR> key to commence search.
  999.  
  1000.          USING MOUSE:
  1001.  
  1002.               Click the OPTION/ESC Button to bring  up  the  popup menu
  1003.          then select the "Find File" suboption on the FILE  submenu  by
  1004.          clicking on it with the Action Button.  All the  find  options
  1005.          remain as discussed in previous paragraphs.   To use the mouse
  1006.          simply click the Action Button while the  mouse  is on  top of
  1007.          the desired option.
  1008.  
  1009.               +-----------------------------+         +----------+
  1010.          -----|     FREE ON OTHER DRIVE     |---------| "Alt-F"  |-----
  1011.               +-----------------------------+         +----------+
  1012.  
  1013.              This option will allow the user to find out the  available
  1014.          space  (free  bytes) of any drive without having to switch off
  1015.          the current drive.  This option would  most  appropriately  be
  1016.          used  when  tagging  files  on  the  current  drive to copy to
  1017.          another drive.  In this way the user can get a rough  estimate
  1018.          as  to  how  many  files can be tagged and copied to the other
  1019.          drive.  The number of free bytes on the other  drive  will  be
  1020.          displayed  in  the lower right corner of the box border,  just
  1021.          above the display of the number of bytes tagged on the current
  1022.          drive.  Due to the nature of file space allocation by DOS  (in
  1023.          clusters of varying sizes on different media), you will not be
  1024.          able  to  copy as many bytes from one media to the other media
  1025.          as specified in this option.  In other words,  expect to  copy
  1026.          fewer than the number of free bytes displayed by this option.
  1027.  
  1028.          USING KEYBOARD:
  1029.  
  1030.               Depress the "ALT" and "f" keys together, then depress the
  1031.          letter of the drive of interest.
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.                                     - 16 - 
  1045.  
  1046.  
  1047.  
  1048.               +-----------------------------+         +----------+
  1049.          -----|          HELP MENU          |---------|   "?"    |-----
  1050.               +-----------------------------+         +----------+
  1051.  
  1052.          USING KEYBOARD:
  1053.  
  1054.              The help menu  will display a  one  page  summary  of  all
  1055.          available   options.   Expanded   context-sensitive   help  is
  1056.          available by depressing the F10 key.
  1057.  
  1058.          USING MOUSE:
  1059.  
  1060.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1061.          then select the appropriate suboption on the HELP  submenu  by
  1062.          clicking on it with the Action Button.
  1063.  
  1064.  
  1065.               +-----------------------------+         +----------+
  1066.          -----|     COPY TAGGED FILES       |---------|   "K"    |-----
  1067.               +-----------------------------+         +----------+
  1068.  
  1069.          USING KEYBOARD:
  1070.  
  1071.              The  copy  tagged files option  will copy those files that
  1072.          are tagged (see Option "T" below) to  a  specified  directory.
  1073.          The  user  will specify the desired destination directory.  If
  1074.          the user desires to make a second copy of a file in  the  same
  1075.          directory, specify only the new name of the file.  If the user
  1076.          specifies only a drive specification such as "a:", the program
  1077.          will  copy  the  tagged files to the current directory on that
  1078.          drive.  If the user does not specify a  destination  directory
  1079.          but simply enters a carriage return, the program will copy the
  1080.          tagged  files to the directory which is currently highlighted.
  1081.          When choosing this last method of specifying  the  destination
  1082.          directory,  prior to entering the carriage return the user may
  1083.          change the highlighted directory with the use of the  F1  thru
  1084.          F8  keys.  The  program will not allow the user to copy a file
  1085.          or files to  the  same  directory  without  specifying  a  new
  1086.          filename.  In other words, no copy will take place if the user
  1087.          simply  enters a carriage return and the highlighted directory
  1088.          also happens to be the current  directory.  This  prevents the
  1089.          system from trying to copy a file onto itself and consequently
  1090.          clobbering itself.
  1091.  
  1092.              If in  the  split  screen  mode,  users  can  specify  the
  1093.          destination directory for a copy command  with an  "*"  if the
  1094.          desired destination directory  is  the  highlighted  directory
  1095.          on the "other display" of the split screen display mode.   The
  1096.          "*" can also be used  if  in  the  full  screen mode  and  the
  1097.          desired destination is the highlighted directory in the  other
  1098.          full screen "FLIP" mode.
  1099.  
  1100.  
  1101.  
  1102.                                     - 17 - 
  1103.  
  1104.  
  1105.  
  1106.          USING MOUSE:
  1107.  
  1108.               After tagging the appropriate files, depress  the  Action
  1109.          Button ANYWHERE in the File Box, drag the  mouse  (with Action
  1110.          Button  still depressed)  to the  Available Drive Letters,  to
  1111.          one of the directories on the Directory Tree, or to the  other
  1112.          File Box of a split-screen display.  Release the Action Button
  1113.          on a Drive Letter, Directory, or File Box.  A popup menu  will
  1114.          appear showing the destination  directory  and  an  option  to
  1115.          either copy or move the desired files.  The default is to copy
  1116.          tagged files and  simply  clicking the  Action Button  on  the
  1117.          popup menu will accomplish the copy.
  1118.  
  1119.               +-----------------------------+         +----------+
  1120.          -----|        COLOR CHANGE         |---------| "Alt-K"  |-----
  1121.               +-----------------------------+         +----------+
  1122.  
  1123.             The DS program will allow the user  with  a  color/graphics
  1124.          monitor to change the color of the foreground,  background and
  1125.          display border.
  1126.  
  1127.          USING KEYBOARD:
  1128.  
  1129.               To enable these color changes the user  first selects the
  1130.          ALT-K option, whereupon the following keys are used:
  1131.  
  1132.             F1 Key  - Change/Increment the  display  foreground  color.
  1133.                       The foreground cycles thru 16 colors.
  1134.  
  1135.             F2 Key  - Change/Increment the  display  background  color.
  1136.                       The background cycles thru 8 colors.
  1137.  
  1138.             F3 Key  - Change/Increment the display  border  color.  The
  1139.                       border cycles thru 8 colors.
  1140.  
  1141.             F4 Key  - Modify the defaults startup file "ds_prog.def" so
  1142.                       that current selected  colors  will  be  used  on
  1143.                       future initializations of the program.
  1144.  
  1145.             F5 Key  - Modify the default colors used  when  not  within
  1146.                       the DS program. This option requires the presence
  1147.                       of the ansi.sys device driver.
  1148.  
  1149.             F6 Key  - Modify the color/mono attributes on  the  display
  1150.                       to  conform  with a  monochrome  display.    This
  1151.                       option might be  necessary  should  the  defaults
  1152.                       file   contain   color   attributes   which   are
  1153.                       undesirable  (ie:  underline)  for  a  monochrome
  1154.                       display.
  1155.  
  1156.             To exit the color change  option,  depress  the  Return  or
  1157.          Escape key.
  1158.  
  1159.  
  1160.                                     - 18 - 
  1161.  
  1162.  
  1163.  
  1164.          USING MOUSE:
  1165.  
  1166.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1167.          then select the "Colors" suboption on  the  SETUP  submenu  by
  1168.          clicking on it with the Action Button.   All the Color options
  1169.          remain as discussed in previous paragraphs, simply  click  the
  1170.          Action Button while the mouse is on top of the desired option.
  1171.  
  1172.               +-----------------------------+       +------------+
  1173.          -----|          LIST FILE          |-------|"L"  "Alt-L"|-----
  1174.               +-----------------------------+       +------------+
  1175.  
  1176.             The list option will allow the user to list the contents of
  1177.          the  current  "indicated  file".  The  user  must  supply  and
  1178.          identify the desired lister program to the DS program.  The DS
  1179.          program does not provide a lister  program  of  its  own,  but
  1180.          simply  attempts  to  execute a ".com" or ".exe" file that has
  1181.          been defined by  the  "Ctrl-E"  option as the default  lister.
  1182.          The user should specify a complete pathname  for  the  desired
  1183.          lister program with the "Ctrl-E" option.  If  the user has not
  1184.          previously defined a lister  program  to the DS  program,  the
  1185.          program  will  attempt  to  execute  a  file  by  the  name of
  1186.          "list.com",  "list.exe",  or "list.bat".
  1187.  
  1188.             If the user does not have  a  lister  program  they  should
  1189.          create a  "list.bat"  with  "type %1" and "pause"  as the only
  1190.          2 lines in the file which  "ctrl-e"  maintains  as  the lister
  1191.          file.  This way the file will  be  listed  via  the DOS "type"
  1192.          command.  An  outstanding  lister program  by  Vernon D. Buerg
  1193.          is  available in the  "shareware" environment  which is highly
  1194.          recommended for your use.
  1195.  
  1196.               The "l" option will list the indicated file while  the DS
  1197.          program stays resident in  memory.   The  "alt-l"  option will
  1198.          list the indicated file while overlaying the DS program.  Upon
  1199.          termination of the  "alt-l"  option the  DS  program  will  be
  1200.          reloaded from disk.   The  "alt-l"  option is slower to reload
  1201.          or restart DS but useful in systems that are tight on  memory.
  1202.          Upon reloading DS the "alt-l" option  should  retain  the same
  1203.          current "indicated  file";  however, all tagging of files will
  1204.          be lost.
  1205.  
  1206.               The edit defaults option ("Ctrl-E")  contains a selection
  1207.          item  that will instruct the program to automatically use  the
  1208.          "alt-l"   option even if the "l"  option was selected  if  the
  1209.          amount  of  available memory is less than a  specified  value.
  1210.          The specified amount of memory is user tunable. Selecting 590k
  1211.          for the memory limit will force the program to always use  the
  1212.          overlay option.  Selecting  10k  for  the  memory  limit  will
  1213.          prevent the overlay option from being used  in  place  of  the
  1214.          normal option.
  1215.  
  1216.  
  1217.  
  1218.                                     - 19 - 
  1219.  
  1220.  
  1221.  
  1222.          USING KEYBOARD:
  1223.  
  1224.               Depress the "l" key when  the  "current file"  indicators
  1225.          are on both sides of the desired filename.
  1226.  
  1227.          USING MOUSE:
  1228.  
  1229.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1230.          then select the  "List"  suboption  on  the  FILE  submenu  by
  1231.          clicking on it with the Action Button.
  1232.  
  1233.               +-----------------------------+         +----------+
  1234.          -----|    LIMITS OF THE PROGRAM    |---------| "Ctrl-L" |-----
  1235.               +-----------------------------+         +----------+
  1236.  
  1237.              This option will show and optionally  change  the  program
  1238.          limits.   Maximum Directories per Drive (MAXDIR)  and  Maximum
  1239.          Files per Directory (MAXFILES) can be  changed  to  suit  user
  1240.          needs.  Additionally  the  program  can  be  tailored  to  use
  1241.          expanded memory (EMS) or normal DOS  memory  to  maintain  the
  1242.          MAXDIR and MAXFILES data structures.
  1243.  
  1244.              After selecting "CTRL-L" to show the  program  limits  the
  1245.          user will see a display on the bottom 4 lines as follows:
  1246.  
  1247.                         'M' = Modify Limits
  1248.          --- DS Ver 4.10  ---  Limit  Used  |- Log Drives -|  Prog Size
  1249.          Dir per Drive - EMS     512   173  |     CD       |    DOS 77k
  1250.          Files per Dir - EMS     600    89  |--------------|    EMS 64k
  1251.  
  1252.              To modify program limits hit the "m" key. The display will
  1253.          change to the following:
  1254.  
  1255.          ESC=Cnx/Rtn   [Tab]     +-    CR=Process
  1256.          --- DS Ver 4.10  ---  Limit  Used  |- Log Drives -|  Prog Size
  1257.          Dir per Drive - EMS <-> 512   173  |     CD       |    DOS 77k
  1258.          Files per Dir - EMS     600    89  |--------------|    EMS 64k
  1259.  
  1260.              The blinking left-right arrow will indicate which  program
  1261.          limit you can currently modify.  Here the arrow indicates that
  1262.          the MAXDIR limits  can  be  modified.   The  others  keys  now
  1263.          available for modifying limits are as follows:
  1264.  
  1265.             ESC key = Cancel any changes and return to main menu.
  1266.           [Tab] key = Toggle this limit from EMS to DOS or vice versa.
  1267.          Arrow keys = Switch to modifying the other program limit.
  1268.             +- keys = Increase or decrease the program limit.
  1269.            <CR> key = Process the currently displayed program limits.
  1270.  
  1271.              Once the limits have been modified as  desired,  the  user
  1272.          MUST HIT THE <CR> KEY FOR THE PROGRAM TO PROCESS THE REQUESTED
  1273.          CHANGES.  When the program processes the requested changes  it
  1274.  
  1275.  
  1276.                                     - 20 - 
  1277.  
  1278.  
  1279.  
  1280.          will deallocate/reallocate memory and  rescan  the  disks  for
  1281.          directory structure information.  Hit the ESC key to return to
  1282.          the main menu after the desired changes have been processed.
  1283.  
  1284.               This option  will  allow the following new limits for the
  1285.          program.
  1286.  
  1287.             MAXDIR  -  100 to 2000 (using DOS) in increments of 100
  1288.                        512 to 2048 (using EMS) in increments of 512
  1289.  
  1290.             MAXFILES - 200 to 2500 (EMS & DOS) in increments of 100
  1291.  
  1292.              A maximum of 128k of EMS memory can be used to  store  the
  1293.          MAXDIR  and  MAXFILES  data  structures,   thereby  conserving
  1294.          DOS memory for other application  programs.  The  MAXDIR  data
  1295.          structure has priority in  using  EMS  memory.   If  the  user
  1296.          increases the amount of  EMS  memory  that  MAXDIR  uses,  the
  1297.          program may automatically  switch  the  MAXFILES  to  use  DOS
  1298.          memory vice EMS to ensure that the desired MAXFILES  limit  is
  1299.          not reduced.
  1300.  
  1301.             Example:
  1302.                  MAXDIR =  1536 EMS   (uses 96k EMS)
  1303.                  MAXFILES = 600 EMS   (uses 32k EMS)
  1304.  
  1305.              User increments MAXDIR limit to 2048 EMS
  1306.  
  1307.                  MAXDIR =  2048 EMS   (uses 128k EMS)
  1308.                  MAXFILES = 600 DOS <-- program automatically  switches
  1309.                                         to using DOS memory so that the
  1310.                                            600 limit can be maintained.
  1311.          USING KEYBOARD:
  1312.  
  1313.               Depress the "CONTROL" and "l" keys together.  Depress the
  1314.          "m" key if modifications are desired.  Depress the  Tab,  "+",
  1315.          "-", up-arrow, down-arrow, and <CR> to modify the limits.
  1316.  
  1317.          USING MOUSE:
  1318.  
  1319.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1320.          then  select  the  "Program Limits"  suboption  on  the  SETUP
  1321.          submenu by clicking on it with the Action Button.   The  mouse
  1322.          will be locked on the bottom screen  border.   To  modify  the
  1323.          program limits, position the mouse over the  option  displayed
  1324.          in the bottom border  and  click  the  Action  Button  on  the
  1325.          desired option.
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.                                     - 21 - 
  1335.  
  1336.  
  1337.  
  1338.               +-----------------------------+         +----------+
  1339.          -----|      MOVE TAGGED FILES      |---------|   "M"    |-----
  1340.               +-----------------------------+         +----------+
  1341.  
  1342.              The move tagged files option allows the user to move those
  1343.          files  tagged  (see  Option "T" below) to another directory on
  1344.          the  same or a different drive.   The user can either  specify
  1345.          the   desired   destination   directory   or  enter  simply  a
  1346.          carriage return.   If the user enters only a  carriage return,
  1347.          the  program   will  move   all  the   tagged  files   to  the
  1348.          directory which is currently highlighted.  When choosing  this
  1349.          method  of specifying the destination directory,  the user may
  1350.          change the highlighted directory with  the  F1  thru  F8  keys
  1351.          prior  to  entering  the  carriage return.  Additionally,  the
  1352.          highlighted  directory  must be  different  from  the  current
  1353.          directory (the one in which the tagged files  are in) for this
  1354.          method of entering only a carriage return to work.
  1355.  
  1356.              If in  the  split  screen  mode,  users  can  specify  the
  1357.          destination directory for a move command  with an  "*"  if the
  1358.          desired destination directory  is  the  highlighted  directory
  1359.          on the "other display" of the split screen display mode.   The
  1360.          "*" can also be used  if  in  the  full  screen mode  and  the
  1361.          desired destination is the highlighted directory in the  other
  1362.          full screen "FLIP" screen.
  1363.  
  1364.          USING KEYBOARD:
  1365.  
  1366.               After tagging appropriate files,  depress  the  "m"  key,
  1367.          then either type in the destination directory, depress the "*"
  1368.          key, or hit a <CR> to move files to the highlighted directory.
  1369.  
  1370.          USING MOUSE:
  1371.  
  1372.               After tagging the appropriate files,  depress the  Action
  1373.          Button ANYWHERE in the File Box,  drag the mouse (with  Action
  1374.          Button still depressed) to the Available Drive Letters, to one
  1375.          of the directories on the Directory Tree, or to the other File
  1376.          Box of a split-screen display.  Release the Action Button on a
  1377.          Drive Letter,  on or next to a Directory, or in the other File
  1378.          Box.   A  popup  menu  will  appear  showing  the  destination
  1379.          directory  and an  option  to either copy or move the  desired
  1380.          files.   The default is to COPY tagged  files so the USER MUST
  1381.          MOVE THE MOUSE OVER TO THE MOVE BOX option before clicking the
  1382.          Action Button to accomplish the move.
  1383.  
  1384.               +-----------------------------+         +----------+
  1385.          -----|  25 43/50 LINE MODE TOGGLE  |---------| "Alt-M"  |-----
  1386.               +-----------------------------+         +----------+
  1387.  
  1388.              The expanded 43/50 line toggle  will  allow  the  user  to
  1389.          switch back and forth  from 25 lines  to  43(EGA)  or  50(VGA)
  1390.  
  1391.  
  1392.                                     - 22 - 
  1393.  
  1394.  
  1395.  
  1396.          lines per display on monitors  supporting  such  modes.   When
  1397.          exiting the DS program the user is  automatically  placed back
  1398.          in  the 25  line mode.   Should the user exit the  DS  program
  1399.          while  in  the 43/50  line mode and subsequently  reenter  the
  1400.          program,  the user will be placed back in the 43/50 line mode.
  1401.  
  1402.          USING KEYBOARD:
  1403.  
  1404.               Depress the "ALT" and "m" keys together.
  1405.  
  1406.          USING MOUSE:
  1407.  
  1408.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1409.          then select the "25 43/50 Line" suboption on the SETUP submenu
  1410.          by clicking on it with the Action Button.
  1411.  
  1412.               +-----------------------------+       +------------+
  1413.          -----|     PRINT TAGGED FILES      |-------|"P"  "Alt-P"|-----
  1414.               +-----------------------------+       +------------+
  1415.  
  1416.              The print tagged files option allows the user to  send  to
  1417.          the  print  program a maximum of 10 tagged files.  This option
  1418.          simply sends to the user-specified "print" program  the  first
  1419.          10  tagged  files.   The  user  specifies  the  desired  print
  1420.          program  through  the  use  of  the  "Ctrl-E"  (edit defaults)
  1421.          option.
  1422.  
  1423.               The edit defaults option ("Ctrl-E")  contains a selection
  1424.          item  that will instruct the program to automatically use  the
  1425.          "alt-p"   option even if the "p"  option was selected  if  the
  1426.          amount  of  available memory is less than a  specified  value.
  1427.          The specified amount of memory is user tunable. Selecting 590k
  1428.          for the memory limit will force the program to always use  the
  1429.          overlay option.  Selecting  10k  for  the  memory  limit  will
  1430.          prevent the overlay option from being used  in  place  of  the
  1431.          normal option.
  1432.  
  1433.          USING KEYBOARD:
  1434.  
  1435.               After tagging appropriate files depress the "p" key.
  1436.  
  1437.          USING MOUSE:
  1438.  
  1439.               After tagging the appropriate files click the  OPTION/ESC
  1440.          Button to bring up the popup  menu  then  select  the  "Print"
  1441.          suboption on the FILE submenu  by  clicking  on  it  with  the
  1442.          Action Button.
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.                                     - 23 - 
  1451.  
  1452.  
  1453.  
  1454.               +-----------------------------+         +----------+
  1455.          -----|        RENAME FILE          |---------|   "R"    |-----
  1456.               +-----------------------------+         +----------+
  1457.  
  1458.              The rename option allows the user to rename the  indicated
  1459.          file to a new name.
  1460.  
  1461.          USING KEYBOARD:
  1462.  
  1463.               Depress the "r" key when  the  "current file"  indicators
  1464.          are on both sides of the desired file.
  1465.  
  1466.          USING MOUSE:
  1467.  
  1468.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1469.          then select the "Rename" suboption  on  the  FILE  submenu  by
  1470.          clicking on it with the Action Button.
  1471.  
  1472.               +-----------------------------+         +----------+
  1473.          -----|      RESCAN DIRECTORY       |---------| "Alt-R"  |-----
  1474.               +-----------------------------+         +----------+
  1475.  
  1476.              The directory rescan  option  will  rescan  the  directory
  1477.          structure  of  the current default drive.  This option may  be
  1478.          necessary if you switch floppies in a  floppy  drive.  It  may
  1479.          also  be used on a hard disk if you make or delete directories
  1480.          without using  the  directory  modification  (CTRL-D)  option.
  1481.  
  1482.          USING KEYBOARD:
  1483.  
  1484.               Depress the "ALT" and "r" keys together, then depress the
  1485.          "y" key to confirm a rescan is desired.
  1486.  
  1487.          USING MOUSE:
  1488.  
  1489.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1490.          then select the "Rescan Tree" suboption on the TREE submenu by
  1491.          clicking on it with the Action Button.
  1492.  
  1493.               +-----------------------------+         +----------+
  1494.          -----|       REFRESH SCREEN        |---------| "CTRL-R" |-----
  1495.               +-----------------------------+         +----------+
  1496.  
  1497.              The  refresh  screen  option will allow the user to redraw
  1498.          the entire screen.  This may become  necessary  should  a  DOS
  1499.          message like "Abort, Retry or Ignor" disrupt the screen.
  1500.  
  1501.          USING KEYBOARD:
  1502.  
  1503.               Depress the "CONTROL" and "r" keys together.
  1504.  
  1505.  
  1506.  
  1507.  
  1508.                                     - 24 - 
  1509.  
  1510.  
  1511.          USING MOUSE:
  1512.  
  1513.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1514.          then  select  the  "Refresh Screen"  suboption  on  the  SETUP
  1515.          submenu by clicking on it with the Action Button.
  1516.  
  1517.               +-----------------------------+         +----------+
  1518.          -----|        SPLIT SCREEN         |---------|   "S"    |-----
  1519.               +-----------------------------+         +----------+
  1520.  
  1521.              The   split screen option will allow the user to display 2
  1522.          different  directories  on the screen  at the  same time.  The
  1523.          directories  can  be on  the same  or different  drives.  Upon
  1524.          selecting the split screen option the top and bottom halves of
  1525.          the screen will display the same directory.  The user can then
  1526.          change  either  the  top  or bottom  display  to  a  different
  1527.          directory and/or drive.  To switch the active display from top
  1528.          to bottom or from bottom to top,  use the '+' key.   Selecting
  1529.          the  "s"   option when already in the split screen  mode  will
  1530.          cause the display to revert to the full screen mode.
  1531.  
  1532.          USING KEYBOARD:
  1533.  
  1534.               Depress the "s" key to switch in and out of split screen.
  1535.  
  1536.          USING MOUSE:
  1537.  
  1538.               Click the Action Button on the Right Bottom Screen Border.
  1539.  
  1540.               +-----------------------------+         +----------+
  1541.          -----|        SELECT & SORT        |---------| "Alt-S"  |-----
  1542.               +-----------------------------+         +----------+
  1543.  
  1544.              The select &  sort  option  allows  the  user  to  specify
  1545.          alternate sorts of the files in a directory.  Additionally, it
  1546.          allows  the user to filter out some files by allowing entry of
  1547.          a file match  parameter  to  use  rather  than  accepting  the
  1548.          default   file   match   parameter  of  "*.*".   Upon  program
  1549.          initialization the defaults are a filter of "*.*" with a  sort
  1550.          by filename in ascending order.
  1551.  
  1552.          USING KEYBOARD:
  1553.  
  1554.              After  selecting  this  option the user may change any/all
  1555.          the defaults.  Depressing the space bar will toggle  the  sort
  1556.          option through the 5 sort types of no sort,  name,  extension,
  1557.          size and date.  Depressing the up arrow  or  down  arrow  will
  1558.          toggle   the   sort   direction  to  ascending  or  descending
  1559.          respectively.  Entry of any other valid character  will  allow
  1560.          the  user  to change the file match parameter.  Depressing the
  1561.          carriage return character after valid  file  filter  parameter
  1562.          characters  will change the file filter to the newly specified
  1563.          file filter.  Depressing the carriage return character without
  1564.  
  1565.  
  1566.                                     - 25 - 
  1567.  
  1568.  
  1569.  
  1570.          any new file filter entered will change the file  filter  back
  1571.          to "*.*".
  1572.  
  1573.              The  new  sort  and  file  select  filter take effect upon
  1574.          termination of the sort/select option,  upon pressing the  ESC
  1575.          key.  After  terminating  this option the new sort option will
  1576.          be displayed on the 1st of the 3 bottom  status  lines,  right
  1577.          after  the  "Help  =  ?"  message.  Additionally,  if the file
  1578.          select filter  is  anything  other  than  "*.*",  it  will  be
  1579.          displayed  above  and  slightly  to  the  right  of  the  sort
  1580.          type/direction in the display border.
  1581.  
  1582.          USING MOUSE:
  1583.  
  1584.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1585.          then select the "Sort & Select" suboption on the FILE  submenu
  1586.          by clicking on it with the Action Button.  All  the  sort  and
  1587.          select options remain as discussed  above,  simply  click  the
  1588.          Action Button while the mouse is on top of the desired option.
  1589.  
  1590.               +-----------------------------+         +----------+
  1591.          -----|      SET MOUSE DEFAULTS     |---------| "Ctrl-S" |-----
  1592.               +-----------------------------+         +----------+
  1593.  
  1594.              The  set mouse defaults allows the user to adjust  various
  1595.          parameters of the mouse.  The mouse can be turned on and  off,
  1596.          have its appearance, color, and blink status changed, have the
  1597.          Action  and  Option/Esc   Buttons  switched,  and  adjust  the
  1598.          directory  speed parameter.   Once the user has selected  this
  1599.          option,  the suboption selections are activated by  depressing
  1600.          the appropriatly highlighted keys.   Exiting this routine will
  1601.          update the startup default parameters.
  1602.  
  1603.          USING KEYBOARD:
  1604.  
  1605.               Depress the "CONTROL" and "s" keys together, then depress
  1606.          the desired suboption keys "m", "t", "f", "c", "b", "+" and/or
  1607.          "-".  Press ESC to terminate the option.
  1608.  
  1609.          USING MOUSE:
  1610.  
  1611.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1612.          then  select  the "Mouse"  suboption on the SETUP  submenu  by
  1613.          clicking on it with the Action Button.  All the  mouse default
  1614.          suboptions  remain  as  discussed  above,   simply  click  the
  1615.          Action Button while the mouse is on top of the desired option.
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.                                     - 26 - 
  1625.  
  1626.  
  1627.  
  1628.               +-----------------------------+         +----------+
  1629.          -----|         TOGGLE TAG          |---------|   "T"    |-----
  1630.               +-----------------------------+         +----------+
  1631.  
  1632.              The toggle tag option is used to tag or untag a  file as a
  1633.          precursor to other options  such  as  the  copy  tagged  files
  1634.          option.  When this option is selected, the  current  indicated
  1635.          file is either tagged (if untagged)  or  untagged  (if tagged)
  1636.          and the next file becomes the current indicated file.
  1637.  
  1638.          USING KEYBOARD:
  1639.  
  1640.               Depress the "t" key while the  "current file"  indicators
  1641.          are on both sides of the filename.
  1642.  
  1643.          USING MOUSE:
  1644.  
  1645.               Position mouse on top of desired filename and  click  the
  1646.          Action Button.
  1647.  
  1648.               +-----------------------------+         +----------+
  1649.          -----|       TAG ALL FILES         |---------| "Alt-T"  |-----
  1650.               +-----------------------------+         +----------+
  1651.  
  1652.              The  tag  all  files option allows the user to tag all the
  1653.          files in the current directory in preparation for execution of
  1654.          another option.
  1655.  
  1656.          USING KEYBOARD:
  1657.  
  1658.               Depress the "ALT" and "t" keys together.
  1659.  
  1660.          USING MOUSE:
  1661.  
  1662.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1663.          then select the "Tag All" suboption on  the  TAGS  submenu  by
  1664.          clicking on it with the Action Button.
  1665.  
  1666.               +-----------------------------+         +----------+
  1667.          -----|       CONTROL TAGGING       |---------| "Ctrl-T" |-----
  1668.               +-----------------------------+         +----------+
  1669.  
  1670.              The  control tagging option will allow the user to tag  or
  1671.          untag  files  based on matches with filenames,   dates  and/or
  1672.          sizes.
  1673.  
  1674.          USING KEYBOARD:
  1675.  
  1676.              UP/DOWN  Arrows - Will cycle through the selection options
  1677.          (name, date or size) the user will be selecting.
  1678.  
  1679.  
  1680.  
  1681.  
  1682.                                     - 27 - 
  1683.  
  1684.  
  1685.  
  1686.              LEFT/RIGHT  Arrows  -  Will cycle  through  the  selection
  1687.          criteria for a particular name, date or size option.
  1688.  
  1689.              <SPACE>  -  The space bar will toggle some of the criteria
  1690.          for name,  date or size options.   Normally the space bar will
  1691.          toggle  between  a specified filename,  date or size  and  the
  1692.          "[other_screen]"  option.  The [other_screen] option indicates
  1693.          that the program should compare the file names, dates or sizes
  1694.          of the current directory with those on the "other screen" when
  1695.          the split/flip screen option has been previously selected.
  1696.  
  1697.              <TAB> - The TAB key will cycle through the month,  day and
  1698.          year criteria of the date option.
  1699.  
  1700.              <+>  - The plus key will increment the month,  day or year
  1701.          criteria of the date option.
  1702.  
  1703.              <->  - The minus key will decrement the month, day or year
  1704.          criteria of the date option.
  1705.  
  1706.              Once  the  user has setup the selection criteria  for  the
  1707.          name,  date and size options the tagging or untagging of files
  1708.          based  on such criteria is accomplished by selecting  <CTRL-T>
  1709.          or <CTRL-U> respectively.
  1710.  
  1711.              The <CR>  and F1 thru F8 keys function normally under this
  1712.          option,   allowing  the  user to move to and  enter  different
  1713.          directories.  Additionally the <Alt-T> and <Alt-U> options are
  1714.          enabled,   allowing the user to tag or untag all  the  current
  1715.          files.
  1716.  
  1717.              The  "Missing"   criteria  under the  Name  option  always
  1718.          compares  the files in the current directory against those  in
  1719.          the "other_screen".  If the "Missing" criteria is selected for
  1720.          the Name option then the "[other_screen]"  cannot be  selected
  1721.          for either the date or size options.
  1722.  
  1723.          USING MOUSE:
  1724.  
  1725.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1726.          then select the "Control Tags" suboption on the  TAGS  submenu
  1727.          by clicking on it with the Action Button.  All the control tag
  1728.          options remain as discused in  the  paragraphs  above,  simply
  1729.          click the Action Button while the mouse is positioned  on  top
  1730.          of the desired option.
  1731.  
  1732.               +-----------------------------+         +----------+
  1733.          -----|         UNTAG FILES         |---------|   "U"    |-----
  1734.               +-----------------------------+         +----------+
  1735.  
  1736.              The  untag option allows the user to untag a file that has
  1737.          been tagged by mistake.
  1738.  
  1739.  
  1740.                                     - 28 - 
  1741.  
  1742.  
  1743.  
  1744.  
  1745.          USING KEYBOARD:
  1746.  
  1747.               Depress the "u" key while the  "current file"  indicators
  1748.          are on both sides of the filename.
  1749.  
  1750.          USING MOUSE:
  1751.  
  1752.               Position mouse on top of tagged filename  and  click  the
  1753.          Action Button.
  1754.  
  1755.               +-----------------------------+         +----------+
  1756.          -----|       UNTAG ALL FILES       |---------| "Alt-U"  |-----
  1757.               +-----------------------------+         +----------+
  1758.  
  1759.              The untag all files option allows the user  to  untag  all
  1760.          the files that are currently tagged.
  1761.  
  1762.          USING KEYBOARD:
  1763.  
  1764.               Depress the "ALT" and "u" keys together.
  1765.  
  1766.          USING MOUSE:
  1767.  
  1768.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1769.          then select the "UnTag All" suboption on the TAGS  submenu  by
  1770.          clicking on it with the Action Button.
  1771.  
  1772.               +-----------------------------+         +----------+
  1773.          -----|      UTILITY TREE DUMP      |---------| "Ctrl-U" |-----
  1774.               +-----------------------------+         +----------+
  1775.  
  1776.              The tree dump utility  option  will  create  a  file  that
  1777.          contains the tree structure diagram which is displayed  on the
  1778.          left side of the DS display screen.  The user will be prompted
  1779.          to enter a name for the output file.
  1780.  
  1781.               +-----------------------------+         +----------+
  1782.          -----|      VOLUMN ID TOGGLE       |---------| "Ctrl-V" |-----
  1783.               +-----------------------------+         +----------+
  1784.  
  1785.              The volumn id toggle option will turn on/off  the  display
  1786.          of the default drive's volumn label.  The volumn  id  will  be
  1787.          displayed in the lower left corner of the display border  when
  1788.          available and turned on.  The default on start  up  is  toggle
  1789.          off.
  1790.  
  1791.          USING KEYBOARD:
  1792.  
  1793.               Depress the "CONTROL" and "v" keys together.
  1794.  
  1795.  
  1796.  
  1797.  
  1798.                                     - 29 - 
  1799.  
  1800.  
  1801.          USING MOUSE:
  1802.  
  1803.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1804.          then select the "Volume Show" suboption on the  SETUP  submenu
  1805.          by clicking on it with the Action Button.
  1806.  
  1807.               +-----------------------------+       +------------+
  1808.          -----|        EXECUTE FILE         |-------|"X"  "Alt-X"|-----
  1809.               +-----------------------------+       +------------+
  1810.  
  1811.              The eXecute file option allows the  user  to  execute  the
  1812.          current  indicated  file if its file name extension is ".com",
  1813.          ".exe", ".bat", or ".bas".   Files with a ".bas" extension are
  1814.          passed as a parameter to the execution of a file by  the  name
  1815.          of "basica.exe". Prior to the execution of any of these files,
  1816.          this  option  allows  the user to enter command line arguments
  1817.          which are passed to the indicated  program  as  it  goes  into
  1818.          execution.
  1819.  
  1820.               The  "x"  option executes  the  indicated  program  while
  1821.          the DS program stays resident in memory.  The  "alt-x"  option
  1822.          will execute the indicated program while  overlaying  the   DS
  1823.          program.  Upon  termination  of  the  "alt-x"  option  the  DS
  1824.          program will be reloaded from disk.   The  "alt-x"  option  is
  1825.          slower to reload/restart DS but useful  in  systems  that  are
  1826.          tight on memory.   Upon reloading DS the "alt-x" option should
  1827.          retain the same current "indicated file"; however, all tagging
  1828.          of files will be lost.
  1829.  
  1830.               The edit defaults option ("Ctrl-E")  contains a selection
  1831.          item  that will instruct the program to automatically use  the
  1832.          "alt-x"   option even if the "x"  option was selected  if  the
  1833.          amount  of  available memory is less than a  specified  value.
  1834.          The specified amount of memory is user tunable. Selecting 590k
  1835.          for the memory limit will force the program to always use  the
  1836.          overlay option.  Selecting  10k  for  the  memory  limit  will
  1837.          prevent the overlay option from being used  in  place  of  the
  1838.          normal option.
  1839.  
  1840.          USING KEYBOARD:
  1841.  
  1842.               Depress the "x" or "ALT" and "x" keys together.  The user
  1843.          can enter command line parameters prior to program execution.
  1844.  
  1845.          USING MOUSE:
  1846.  
  1847.             WITH Command Line Parameters
  1848.  
  1849.               Click the OPTION/ESC Button to bring up  the  popup  menu
  1850.          then select the "Execute" suboption on  the  FILE  submenu  by
  1851.          clicking on it with the  Action Button.   The  user  may  then
  1852.          enter the desired command line parameters.
  1853.  
  1854.  
  1855.  
  1856.                                     - 30 - 
  1857.  
  1858.  
  1859.  
  1860.             WITHOUT Command Line Parameters
  1861.  
  1862.               "Double Click" on the filename (not .ext) to execute  the
  1863.          file and keep DS in memory.
  1864.  
  1865.               "Double Click" on the filename extension to  execute  the
  1866.          file and overlay DS to conserve memory.
  1867.  
  1868.               +-----------------------------+       +------------+
  1869.          -----|         MOUSE TOGGLE        |-------|  "Ctrl-Z"  |-----
  1870.               +-----------------------------+       +------------+
  1871.  
  1872.              The mouse toggle option will toggle the activation of  the
  1873.          mouse.  If the mouse is active,  this  option  will  hide  and
  1874.          deactivate the mouse.   If the mouse is inactive,  this option
  1875.          will  activate  and show the mouse providing the mouse  driver
  1876.          routine has been installed.
  1877.  
  1878.          USING KEYBOARD:
  1879.  
  1880.               Depress the "CONTROL" and "z" keys together.
  1881.  
  1882.               +-----------------------------+       +------------+
  1883.          -----|     SWITCH/FLIP SCREEN      |-------|    "+"     |-----
  1884.               +-----------------------------+       +------------+
  1885.  
  1886.              The  Switch/Flip  Screen  option will allow  the  user  to
  1887.          switch  the active display from top to bottom or bottom to top
  1888.          if  currently  in  the  split screen mode.   If  the  user  is
  1889.          currently  in a full screen mode but had previously been in  a
  1890.          split  screen mode,  selecting '+'  will flip the full  screen
  1891.          mode  to the other screen/display.   When in the  full  screen
  1892.          mode  if there exists another "flip"  screen  available,   the
  1893.          drive letter of the other "flip"  screen will be displayed  in
  1894.          the  directory  display  border just above the bottom  3  line
  1895.          status area.
  1896.  
  1897.          USING KEYBOARD:
  1898.  
  1899.               Depress the "+" key.
  1900.  
  1901.          USING MOUSE:
  1902.  
  1903.               To switch screens when in split screen dual  screen mode,
  1904.          simply move the mouse to the desired screen.  To flip  screens
  1905.          when in full screen mode, simply  click the  Action Button  on
  1906.          the drive letter of the other screen  (hidden screen)  in  the
  1907.          top right corner of the display screen.
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.                                     - 31 - 
  1915.  
  1916.  
  1917.  
  1918.                          +===========================+
  1919.          ================|          MACROS           |=================
  1920.                          +===========================+
  1921.  
  1922.          USING KEYBOARD:
  1923.  
  1924.              Limited macro definitions may be supported thru the use of
  1925.          the following keys:
  1926.  
  1927.                  Shift-F1     thru  Shift-F9       (sF1 - sF9)
  1928.                  Control-F1   thru  Control-F9     (^F1 - ^F9)
  1929.                  Alternate-F1 thru  Alternate-F9   (@F1 - @F9)
  1930.  
  1931.          To display current macro definitions or to change  definitions
  1932.          the following keys may be depressed:
  1933.  
  1934.                  Shift-F10    Control-F10     or   Alternate-F10
  1935.  
  1936.          The  user  will  then  be presented with a display showing the
  1937.          current macro definitions for the appropriate  shift,  control
  1938.          or  alternate  function  keys.  The  user  will  be allowed to
  1939.          select/highlight  the  desired  function  key  and  clear   or
  1940.          reassign  the  defined  macro  for  the selected function key.
  1941.          After changing any macros the user is prompted as  to  whether
  1942.          the changes should be made permanent.
  1943.  
  1944.              The  following  "special key sequences" may be used in the
  1945.          macro definitions:
  1946.  
  1947.                  %F = Filename of the current "indicated file"  will be
  1948.                       inserted in the  macro  at  this  position.   The
  1949.                       filename INCLUDES the filename EXTENSION (ie: the
  1950.                       characters after the period).
  1951.  
  1952.                  %f = Filename of the current "indicated file"  will be
  1953.                       inserted in the  macro  at  this  position.   The
  1954.                       filename DOES NOT INCLUDE the filename EXTENSION.
  1955.  
  1956.                  %c = Clear the display screen before the macro is
  1957.                       executed.
  1958.  
  1959.                  %d = Directory name  (full pathname)  of  the  current
  1960.                       highlighted directory will  be  inserted  in  the
  1961.                       macro at this position.
  1962.  
  1963.                  %R = Return prompting will be required upon completion
  1964.                       of the macro prior to returning to  the  main  DS
  1965.                       menu.  The bottom of the screen  WILL  display  a
  1966.                       message prompting for the prompt character.
  1967.  
  1968.                  %r = Return prompting will be required upon completion
  1969.                       of the macro prior to returning to  the  main  DS
  1970.  
  1971.  
  1972.                                     - 32 - 
  1973.  
  1974.  
  1975.  
  1976.                       menu.  The bottom of the screen WILL NOT  display
  1977.                       the prompting message.
  1978.  
  1979.                  %i = Input from the user is expected  prior  to  macro
  1980.                       execution.  The user will be  prompted  for  this
  1981.                       input.  Be advised  when  using  this  option  in
  1982.                       conjunction with either  %t  or  %T  that  a  "Σ"
  1983.                       (Greek sigma) character will  mark  the  position
  1984.                       where the tagged filenames will be inserted.
  1985.  
  1986.                  %T = Filenames of all currently tagged files  will  be
  1987.                       inserted in macro at this position.  The filename
  1988.                       INCLUDES   the   filename   EXTENSION   (ie:  the
  1989.                       characters after the period). If the user desires
  1990.                       to  seperate  the  filenames  with  a   specified
  1991.                       character string then specify the string (max  of
  1992.                       5 characters) between  double  quotes immediately
  1993.                       after the %T.
  1994.  
  1995.                       Example:
  1996.                           %T"-+"   Specifies that a minus sign followed
  1997.                                    by a plus  sign  seperates  all  the
  1998.                                    filenames in the macro.
  1999.  
  2000.                  %t = Filenames of all currently tagged files  will  be
  2001.                       inserted in macro at this position.  The filename
  2002.                       DOES NOT INCLUDE the filename EXTENSION.  If  the
  2003.                       user desires to  seperate  the  filenames with  a
  2004.                       specified  character  string  then  specify   the
  2005.                       string  (max  of  5  characters)  between  double
  2006.                       quotes immediately  after the  %t.
  2007.  
  2008.                       Example:
  2009.                           %t"+ +"  Specifies that a plus  sign followed
  2010.                                    by a space followed  by a plus  sign
  2011.                                    seperates  all the  filenames in the
  2012.                                    macro.
  2013.  
  2014.                 %1c = Execute the macro command only once.  Some  macro
  2015.                       commands can be executed repeatedly  (like pkarc)
  2016.                       to  accomplish  thier   mission;   however,  some
  2017.                       programs (like link) can only  be  executed  once
  2018.                       to accomplish thier task.  Use "%1"  to  indicate
  2019.                       that the macro must execute only once.   The  "c"
  2020.                       after the "%1" indicates  what  single  character
  2021.                       will  be  used to  terminate  all  but  the  last
  2022.                       line of input to the macro.
  2023.  
  2024.                       Example:
  2025.                           %1+  =  "+" terminates all but the last line.
  2026.                           %1\  =  "\" terminates all but the last line.
  2027.  
  2028.  
  2029.  
  2030.                                     - 33 - 
  2031.  
  2032.  
  2033.  
  2034.                  %O = Overlay the DS program upon executing the  macro.
  2035.                       This will  recover  the  memory used  by  the  DS
  2036.                       program for use by the  macro.   Upon  completion
  2037.                       of the macro the DS program will be restarted  or
  2038.                       reloaded  from   disk.   This  option  is  slower
  2039.                       returning to  DS  but  may  be  useful in systems
  2040.                       that are tight on memory.
  2041.  
  2042.  
  2043.                  %% = A "%" will be inserted in the definition at  this
  2044.                       position.
  2045.  
  2046.          Sample Usage:
  2047.  
  2048.           wp %F         = Execute wordperfect and send it the  filename
  2049.                           (including .ext) of the  current  "indicated"
  2050.                           file.
  2051.  
  2052.           dir /w %d %r  = Do a wide directory listing  on  the  current
  2053.                           highlighted directory and require a prompting
  2054.                           keystroke upon completion prior to  returning
  2055.                           to the main DS menu.
  2056.  
  2057.           del %f.*      = Delete the current "indicated" file  and  all
  2058.                           files  with   the  same  name  but  different
  2059.                           filename extension.
  2060.  
  2061.           erase %i      = Erase the file(s) the user will  input.   The
  2062.                           macro will prompt the user for the input.
  2063.  
  2064.           lark %f       = Execute the  "lark"  (list  archive  utility)
  2065.                           program on the current indicated file.
  2066.  
  2067.           pkzip a newlib %T%O    =  Create a new archive  file  by  the
  2068.                           name of "newlib" and to this file add all the
  2069.                           currently tagged files.  The "pkzip"  program
  2070.                           which does  the  archiving  may  be  executed
  2071.                           repeatedly to archive all the specified files
  2072.                           as DOS can  only  accept  a  maximum  of  128
  2073.                           characters per command line.  This macro will
  2074.                           also overlay (%O) the DS program to  conserve
  2075.                           memory.  DS will be  reloaded/restarted  upon
  2076.                           completion of the macro.
  2077.  
  2078.           lib oldlib -+%t"-+";%R   =   Use the "lib" program to  update
  2079.                           an  old file by  the  name  of  "oldlib"  and
  2080.                           insert into  "oldlib"  new  copies of all the
  2081.                           currently tagged files.  The  characters (-+)
  2082.                           between  the  double  quotes   indicate   the
  2083.                           string to be used  to  seperate  tagged  file
  2084.                           names.  Also require (%R) a return key prompt
  2085.                           on completion of the macro.
  2086.  
  2087.  
  2088.                                     - 34 - 
  2089.  
  2090.  
  2091.  
  2092.  
  2093.           link %t;%1+   = Link  together  into  one   program  all  the
  2094.                           currently  tagged  files.    Since  the  link
  2095.                           program can only be executed once to  do  its
  2096.                           job correctly (unlike repeated executions  of
  2097.                           pkarc to add to an  arc file)  the user  must
  2098.                           specify  that  the   macro   should  only  be
  2099.                           executed once with the  "%1"  sequence.   The
  2100.                           "+"  following the  "%1"  sequence  indicates
  2101.                           that the "+" character will terminate all but
  2102.                           the last of the input lines to the macro.
  2103.  
  2104.          USING MOUSE:
  2105.  
  2106.               The  macros  are  designed to be activated by  using  the
  2107.          keyboard.   The mouse can be used to call up and modify a list
  2108.          of the available macros.  Click the OPTION/ESC Button to bring
  2109.          up  the  popup  menu  then click  the  Action  Button  on  the
  2110.          appropriate macros set on the "MACROS" option.
  2111.  
  2112.               When one of  the  macro  lists  (@F10, sF10, or ^F10)  is
  2113.          displayed, clicking the action button in the  following  areas
  2114.          will invoke the following appropriate responses:
  2115.  
  2116.             On or Left of "=" sign  -  Launch (Execute) the Macro.
  2117.  
  2118.             Right of "=" sign  -  Move highlighter to appropriate Macro
  2119.                              to enable changes to be made to the Macro.
  2120.  
  2121.             On Top 2 lines of display  -  Tab to other Macro Lists.
  2122.  
  2123.  
  2124.          PROGRAMMERS NOTE:  The addition of the "%t", "%T", "%O", "%X",
  2125.          and  the  "%1c"  options have greatly increased the number  of
  2126.          combinations  of  special  option  keys in macros.   With  the
  2127.          limited  time and resources available to the author,  not  all
  2128.          possible  combinations   have  been   thoroughly   tested  for
  2129.          compatability or integrity of operation.  The user may have to
  2130.          tinker with the macro somewhat to get it to operate correctly.
  2131.          In  particular  I have noted that some macros  will  not  work
  2132.          correctly if there are extra (not needed)  spaces in the macro
  2133.          definition.   Some macros (such as those using "%1"  with "%T"
  2134.          or  "%t")  create  a  file  "ds_macro.dat"  in  the  "DS home"
  2135.          directory  which is used as redirected input to the  execution
  2136.          of the macro.  The user may find it useful to review that file
  2137.          if   problems   with   the   macro   execution   occur.    The
  2138.          "ds_macro.dat"  file  is  also used  with the  "%T"  and  "%t"
  2139.          options when the "%O" (overlay) option is also specified.
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.                                     - 35 - 
  2147.  
  2148.  
  2149.  
  2150.                          +===========================+
  2151.          ================|        EXIT OPTION        |=================
  2152.                          +===========================+
  2153.  
  2154.              One exit option is available:
  2155.  
  2156.          USING KEYBOARD:
  2157.  
  2158.              F9 -  Exit in the directory that is currently highlighted.
  2159.  
  2160.          USING MOUSE:
  2161.  
  2162.               Click the OPTION/ESC Button to bring up  the  popup  menu
  2163.          then select the "Exit" option.
  2164.  
  2165.  
  2166.                          +===========================+
  2167.          ================|      REDEFINING KEYS      |=================
  2168.                          +===========================+
  2169.  
  2170.                A limited  capability  for  redefining  the  key/options
  2171.          exists.  The "ds_ovrly.exe" file contains a table of 50 32-bit
  2172.          (2 word or 4 byte) entries  which can redefine a key/option or
  2173.          can prevent the key/option from being used.   The table begins
  2174.          with the ascii string "KEY>"  (excluding quotes) and ends with
  2175.          the ascii string "<KEY" (again no quotes).
  2176.  
  2177.                 The hexadecimal display of the redefinition table looks
  2178.          like the following when seen with "debug", the "Alt-H"  option
  2179.          of Buerg's list program, or most any "byte changer" program.
  2180.  
  2181.                  Note: The 1st 4 bytes (4B 45 59 3E) are the "KEY>"
  2182.                        ascii string used to locate the table.
  2183.  
  2184.                                        -4B 45 59 3E 00 00 01 01
  2185.                 00 00 02 02 00 00 03 03-00 00 04 04 00 00 05 05
  2186.                 00 00 06 06 00 00 07 07-00 00 08 08 00 00 09 09
  2187.                 00 00 10 10 00 00 11 11-00 00 12 12 00 00 13 13
  2188.                 00 00 14 14 00 00 15 15-00 00 16 16 00 00 17 17
  2189.                 00 00 18 18 00 00 19 19-00 00 20 20 00 00 21 21
  2190.                 00 00 22 22 00 00 23 23-00 00 24 24 00 00 25 25
  2191.                 00 00 26 26 00 00 27 27-00 00 28 28 00 00 29 29
  2192.                 00 00 30 30 00 00 31 31-00 00 32 32 00 00 33 33
  2193.                 00 00 34 34 00 00 35 35-00 00 36 36 00 00 37 37
  2194.                 00 00 38 38 00 00 39 39-00 00 40 40 00 00 41 41
  2195.                 00 00 42 42 00 00 43 43-00 00 44 44 00 00 45 45
  2196.                 00 00 46 46 00 00 47 47-00 00 48 48 00 00 49 49
  2197.                 00 00 50 50 3C 4B 45 59-
  2198.  
  2199.                  Note: The last 4 bytes (3C 4B 45 59) are the "<KEY"
  2200.                        ascii string indicating the end of the table.
  2201.  
  2202.  
  2203.  
  2204.                                     - 36 - 
  2205.  
  2206.  
  2207.  
  2208.                 Think of the table between the ascii string terminators
  2209.          as a 50 by 2 array of integers like the following:
  2210.  
  2211.                 4B 45 59 3E    "KEY>" Ascii string terminator/locator
  2212.                 00 00   01 01     1st key redefinition entry
  2213.                 00 00   02 02     2nd key redefinition entry
  2214.                 00 00   03 03      :   :       :         :
  2215.                 00 00   04 04      :   :       :         :
  2216.                 :: ::   :: ::      :   :       :         :
  2217.                 :: ::   :: ::      :   :       :         :
  2218.                 00 00   49 49      :   :       :         :
  2219.                 00 00   50 50     50th key redefinition entry
  2220.                 3C 4B 45 59    "<KEY" Ascii string terminator
  2221.  
  2222.                 To redefine a key/option first list the key you want to
  2223.          redefine followed by how you want it redefined.
  2224.  
  2225.                 Example:  Redefine the following
  2226.                    1) "Alt-C" to be Copy ("K") command
  2227.                    2) "O" to be Drop to DOS ("C" no overlay) option
  2228.                    3) "Alt-O" to be Drop to DOS ("Alt-C" overlay)
  2229.                    4) "A" (File Attribute) option to be locked out
  2230.  
  2231.                 4B 45 59 3E    "KEY>" Ascii string terminator/locator
  2232.                 00 2E   4B 00     "Alt-C" (00 2E) to be "K" (4B 00)
  2233.                 4F 00   43 00     "O" (4F 00) to be "C" (43 00)
  2234.                 00 18   00 2E     "Alt-O" (00 18) to be "Alt-C" (00 2E)
  2235.                 41 00   00 00     "A" (41 00) to lockout (00 00)
  2236.                 :: ::   :: ::      :   :       :         :
  2237.                 :: ::   :: ::      :  rest remains the same
  2238.                 00 00   49 49      :   :       :         :
  2239.                 00 00   50 50     50th key redefinition entry
  2240.                 3C 4B 45 59    "<KEY" Ascii string terminator
  2241.  
  2242.                 The hexadecimal display of the redefinition table after
  2243.          successfully changing the  appropriate  entries  would  be  as
  2244.          follows:
  2245.                                        -4B 45 59 3E 00 2E 4B 00
  2246.                 4F 00 43 00 00 18 00 2E-41 00 00 00 .. .. .. ..
  2247.                 .. .. .. .. .. .. .. ..-.. .. .. .. .. .. .. ..
  2248.                 .. .. .. rest remains the same.. .. .. .. .. ..
  2249.  
  2250.                 The following lists  provide the key  definitions to be
  2251.          used in the redefinition table for the appropriate keys.
  2252.  
  2253.                 A  =  41 00      ^A  =   01 00      @A  =   00 1E
  2254.                 B  =  42 00      ^B  =   02 00      @B  =   00 30
  2255.                 C  =  43 00      ^C  =   03 00      @C  =   00 2E
  2256.                 D  =  44 00      ^D  =   04 00      @D  =   00 20
  2257.                 E  =  45 00      ^E  =   05 00      @E  =   00 12
  2258.                 F  =  46 00      ^F  =   06 00      @F  =   00 21
  2259.                 G  =  47 00      ^G  =   07 00      @G  =   00 22
  2260.  
  2261.  
  2262.                                     - 37 - 
  2263.  
  2264.  
  2265.  
  2266.                 H  =  48 00      ^H  =   08 00      @H  =   00 23
  2267.                 I  =  49 00      ^I  =   09 00      @I  =   00 17
  2268.                 J  =  4A 00      ^J  =   0A 00      @J  =   00 24
  2269.                 K  =  4B 00      ^K  =   0B 00      @K  =   00 25
  2270.                 L  =  4C 00      ^L  =   0C 00      @L  =   00 26
  2271.                 M  =  4D 00      ^M  =   0D 00      @M  =   00 32
  2272.                 N  =  4E 00      ^N  =   0E 00      @N  =   00 31
  2273.                 O  =  4F 00      ^O  =   0F 00      @O  =   00 18
  2274.                 P  =  50 00      ^P  =   10 00      @P  =   00 19
  2275.                 Q  =  51 00      ^Q  =   11 00      @Q  =   00 10
  2276.                 R  =  52 00      ^R  =   12 00      @R  =   00 13
  2277.                 S  =  53 00      ^S  =   13 00      @S  =   00 1F
  2278.                 T  =  54 00      ^T  =   14 00      @T  =   00 14
  2279.                 U  =  55 00      ^U  =   15 00      @U  =   00 16
  2280.                 V  =  56 00      ^V  =   16 00      @V  =   00 2F
  2281.                 W  =  57 00      ^W  =   17 00      @W  =   00 11
  2282.                 X  =  58 00      ^X  =   18 00      @X  =   00 2D
  2283.                 Y  =  59 00      ^Y  =   19 00      @Y  =   00 15
  2284.                 Z  =  5A 00      ^Z  =   1A 00      @Z  =   00 2C
  2285.  
  2286.           F1  =  00 3B   sF1  =  00 54   ^F1  =  00 5E   @F1  =  00 68
  2287.           F2  =  00 3C   sF2  =  00 55   ^F2  =  00 5F   @F2  =  00 69
  2288.           F3  =  00 3D   sF3  =  00 56   ^F3  =  00 60   @F3  =  00 6A
  2289.           F4  =  00 3E   sF4  =  00 57   ^F4  =  00 61   @F4  =  00 6B
  2290.           F5  =  00 3F   sF5  =  00 58   ^F5  =  00 62   @F5  =  00 6C
  2291.           F6  =  00 40   sF6  =  00 59   ^F6  =  00 63   @F6  =  00 6D
  2292.           F7  =  00 41   sF7  =  00 5A   ^F7  =  00 64   @F7  =  00 6E
  2293.           F8  =  00 42   sF8  =  00 5B   ^F8  =  00 65   @F8  =  00 6F
  2294.           F9  =  00 43   sF9  =  00 5C   ^F9  =  00 66   @F9  =  00 70
  2295.           F10 =  00 44   sF10 =  00 5D   ^F10 =  00 67   @F10 =  00 71
  2296.  
  2297.                   UP ARROW    =  00 48
  2298.                   DOWN ARROW  =  00 50
  2299.                   HOME        =  00 47   ^HOME        =  00 77
  2300.                   END         =  00 4F   ^END         =  00 75
  2301.                   LEFT ARROW  =  00 4B   ^LEFT ARROW  =  00 73
  2302.                   RIGHT ARROW =  00 4D   ^RIGHT ARROW =  00 74
  2303.                   PGUP        =  00 49   ^PGUP        =  00 84
  2304.                   PGDN        =  00 51   ^PGDN        =  00 76
  2305.  
  2306.                            1  =  31 00   @1  =  00 78
  2307.                            2  =  32 00   @2  =  00 79
  2308.                            3  =  33 00   @3  =  00 7A
  2309.                            4  =  34 00   @4  =  00 7B
  2310.                            5  =  35 00   @5  =  00 7C
  2311.                            6  =  36 00   @6  =  00 7D
  2312.                            7  =  37 00   @7  =  00 7E
  2313.                            8  =  38 00   @8  =  00 7F
  2314.                            9  =  39 00   @9  =  00 80
  2315.                            0  =  30 00   @0  =  00 81
  2316.  
  2317.                 While the key redefinition  table  can  be  changed  by
  2318.  
  2319.  
  2320.                                     - 38 - 
  2321.  
  2322.  
  2323.  
  2324.          using the DOS "debug" program, it is  recommended  that  users
  2325.          desiring to  change  the table  use a  "byte changer"  program
  2326.          (available on most electronic bulletin boards) which  is  much
  2327.          faster and easier to use than "debug".
  2328.  
  2329.                 A few additional items should be noted when using  this
  2330.          facility to redefine the keys.  They are:
  2331.  
  2332.                   1) The "ds_ovrly.exe" file is (and should be) a read-
  2333.          only file.  To modify the key redefinition table the user must
  2334.          remove the  "read-only"  attribute  from  the  file  prior  to
  2335.          attempting  the  changes  with  a  "byte changer"  or  "debug"
  2336.          program.   After  the changes have been made  to the file,  it
  2337.          should be made a read-only file again.
  2338.  
  2339.                   2) Only the topmost level option keys can be changed.
  2340.          In other words you can  change  the  "Ctrl-D"  (Directory Mod)
  2341.          activation option to another key but within the  Directory Mod
  2342.          option you cannot redefine the "Add", "Delete", "Mount", etc.,
  2343.          activation keys.  It is significant to  remember  that if  you
  2344.          change up/down directory movement from F1/F2 to something else
  2345.          at the topmost level it is NOT reflected at a lower level such
  2346.          as under the "Ctrl-D"  option.   For  this  reason  it is  not
  2347.          recommended you redefine the F1 to F8 Directory  Movement keys
  2348.          nor the File Movement Arrow, Home, End, PgUp,  etc.,  keys  as
  2349.          their redefinitions at the top level would  not  be  reflected
  2350.          at any lower levels.
  2351.  
  2352.                   3) Any changes that  are  made  to  the  redefinition
  2353.          table are NOT reflected in the 1-page help summary  ("?")  nor
  2354.          in the expanded help screens ("F10").
  2355.  
  2356.                   4) Enter the desired key redefinitions  in the  table
  2357.          sequentially starting with  the  1st  key  redefinition  entry
  2358.          (00 00   01 01).  If the first word (00 00) of entry 1 is  all
  2359.          zeros (as the default is), then no key redefinitions  will  be
  2360.          active.  All entries in the redefinition table which  are  not
  2361.          being used should have zero (00 00) as the first word  of  the
  2362.          entry.
  2363.  
  2364.                   5) To lockout an option from use, specify zero (00 00)
  2365.          as the second word of an entry  after  specifying  the  option
  2366.          key you want locked out as the first word of the entry.
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.                                     - 39 - 
  2379.  
  2380.  
  2381.  
  2382.                          +===========================+
  2383.          ================| LICENSING & REGISTRATION  |=================
  2384.                          +===========================+
  2385.  
  2386.                         Directory Scanner (tm) Ver 4.20
  2387.                            Copyright (c)  1986-1991
  2388.                               All Rights Reserved
  2389.                                 by Nat Martino
  2390.  
  2391.          *  A $15 shareware contribution is  requested  for  using  the
  2392.             program.
  2393.          *  The author retains the sole right to sell the program.
  2394.          *  The author grants users the right to  copy  and  distribute
  2395.             the program within the following constraints:
  2396.               - All program files remain unaltered and are  distributed
  2397.                 en masse.
  2398.               - Only the original "non-cloned" version of  the  program
  2399.                 with the  startup/termination  and  drive  change  time
  2400.                 delays is distributed.
  2401.               - No attempt is made to sell  the  program,  or  to  make
  2402.                 money from it or any modified version of it.
  2403.               - The program is not bundled with any other  hardware  or
  2404.                 software transactions without the author's  permission.
  2405.               - Recognized  users'  groups  may  charge  a  maximum  $5
  2406.                 duplication or distribution fee.
  2407.          *  Continued use of the program (more  than 2  weeks)  by  any
  2408.             individual, corporation or  institution  without  a  single
  2409.             user or site license is prohibited.
  2410.          *  Single user licenses are obtained by  sending  in  the  $15
  2411.             shareware contribution.
  2412.          *  Corporations and other institutions  (including  government
  2413.             and educational)  which desire  using  the  program  should
  2414.             refer  to  the   "DS_SITE.LIC"  file   for  site  licensing
  2415.             information.
  2416.          *  Special modified versions of the program can be created  by
  2417.             the  author for different system configurations or desires.
  2418.             Contact the author for details.
  2419.  
  2420.                          +===========================+
  2421.          ================|   WARRANTY & DISCLAIMER   |=================
  2422.                          +===========================+
  2423.  
  2424.                The author disclaims all warranties expressed or implied
  2425.          as to the  quality or performance of this program.  The author
  2426.          will not be held liable for any lost profits, lost savings  or
  2427.          any  other  direct,  indirect,  incidental   or  consequential
  2428.          damages resulting from the use of this program.  Your  use  of
  2429.          this program constitutes your agreement to this disclaimer and
  2430.          your  release of  the author from any  form  of  liability  or
  2431.          litigation.
  2432.  
  2433.  
  2434.  
  2435.  
  2436.                                     - 40 - 
  2437.  
  2438.  
  2439.  
  2440.                       +=======================================+
  2441.          =============| APPENDIX A  -  MOUSE BUTTON SPECIFICS |==========
  2442.                       +=======================================+
  2443.  
  2444.                            MOUSE "ACTION BUTTON" AREAS
  2445.  
  2446.           ┌────────────────────────────────────────────────────────┐
  2447.           │ a  b  c  d <-#1 #2->                c:\sub\home       d│<- #3
  2448.           │     ┌───────────────────────┐ #7  ┌──────────────┐     │
  2449.           │     │ c:\                   │  █  │ file1   .ext │     │
  2450.           │     │ └─sub                 │     │ file2   .ext │     │
  2451.           │  #4 │   ├─home              │  #8 │>file3   .ext<│ #12 │
  2452.           │     │   └─play              │     │              │     │
  2453.           │  _  │                       │  _  │              │  _  │
  2454.           │     │      DIRECTORIES      │     │    FILES     │     │
  2455.           │     │                       │     │              │     │
  2456.           │  #5 │         #6            │  #9 │     #11      │ #13 │
  2457.           │     │                       │     │              │     │
  2458.           │     │                       │  █  │              │     │
  2459.           │     └───────────────────────┘ #10 └──────────────┘     │
  2460.           │               #14                        #15           │
  2461.           └────────────────────────────────────────────────────────┘
  2462.                                                              #16
  2463.          NOTES FOR MOUSE "ACTION BUTTON" AREAS
  2464.  
  2465.          #1  - (TOP BORDER - AVAILABLE DRIVES)
  2466.  
  2467.             "Clicking"  on a  drive letter will switch the  appropriate
  2468.             screen display to the indicated drive.  Hot spots for drive
  2469.             activation  are the drive letter or the blank character  on
  2470.             either side of the drive letter (ie: 3 characters per drive
  2471.             letter).
  2472.  
  2473.             "Dragging"  from the file box (with 1 or more files tagged)
  2474.             and  "Releasing"   on  a  drive  letter  will  initiate   a
  2475.             "Copy/Move"   popup  window routine to either copy or  move
  2476.             (default is copy)  tagged files to the default directory on
  2477.             the indicated drive.
  2478.  
  2479.  
  2480.          #2  - (TOP BORDER - RIGHT OF AVAILABLE DRIVES)
  2481.  
  2482.             "Clicking"   in   this  area  "recenters"    (really   just
  2483.             highlights)   the  tree display on the  current  directory.
  2484.             This enables the user to re-highlight the current directory
  2485.             after  the tree has been scrolled off to other  directories
  2486.             for other purposes.
  2487.  
  2488.          #3  - (TOP BORDER - LAST COLUMN)
  2489.  
  2490.             This  area  will display a drive letter if the user  is  in
  2491.             single-screen mode but had previously been in split  screen
  2492.  
  2493.  
  2494.                                     - 41 - 
  2495.  
  2496.  
  2497.  
  2498.             mode.  The drive letter of the other screen (hidden screen)
  2499.             will  be displayed.  "Clicking"  on the drive  letter  will
  2500.             "flip" the full screen display to the other screen.
  2501.  
  2502.          #4  - (UPPER LEFT BORDER)
  2503.  
  2504.             This area enables the user to scroll up the directory tree.
  2505.             While   the  Action  Button  is  Depressed  in  this   area
  2506.             successive directories further up the tree are highlighted.
  2507.  
  2508.             The  scrolling  speed  can  be  controlled  by  the   user.
  2509.             Depressing  the  "CONTROL"   key while in  this  area  will
  2510.             display  a "Delay"  value.  The larger the delay value  the
  2511.             slower the scrolling speed.  Press "ALT"  key to accelerate
  2512.             the  scrolling speed  (decreases the  delay  value).  Press
  2513.             "LEFT  SHIFT"  to slow the scrolling speed  (increases  the
  2514.             delay value).  Once the desired scrolling speed is obtained
  2515.             press "CONTROL" and "RIGHT SHIFT"   together  to  save  the
  2516.             scrolling speed as a startup default parameter.
  2517.  
  2518.          #5  - (LOWER LEFT BORDER)
  2519.  
  2520.             This  area  enables the user to scroll down  the  directory
  2521.             tree.   While the  Action Button is Depressed in this  area
  2522.             successive   directories   further  down   the   tree   are
  2523.             highlighted.
  2524.  
  2525.             The scrolling speed is controlled as in area #4.
  2526.  
  2527.          #6  - (DIRECTORY BOX)
  2528.  
  2529.             "Releasing"  the Action Button "ON"  a  directory NAME will
  2530.             "ENTER"  the  specified  directory and list files  in  that
  2531.             directory.
  2532.  
  2533.             "Releasing"  the Action Button on a directory LINE (not the
  2534.             name) will just highlight the directory but not enter it.
  2535.  
  2536.             "Dragging"  from the file box (with 1 or more files tagged)
  2537.             and  "Releasing"   ON  a directory  NAME  will  initiate  a
  2538.             "Copy/Move"   popup window routine to either copy  or  move
  2539.             (default is copy)  tagged files to the indicated  directory
  2540.             AND  "ENTER"  the destination directory upon completion  of
  2541.             the option.
  2542.  
  2543.             "Dragging"  from the file box (with 1 or more files tagged)
  2544.             and  "Releasing"  ON a directory LINE (not the name)   will
  2545.             initiate a "Copy/Move"  popup window routine to either copy
  2546.             or  move  (default is copy)  tagged files to the  indicated
  2547.             directory   BUT   remain  in  the  source  directory   upon
  2548.             completion of the option.
  2549.  
  2550.  
  2551.  
  2552.                                     - 42 - 
  2553.  
  2554.  
  2555.  
  2556.          #7  - (TOP CENTER DIVIDER)
  2557.  
  2558.             "Clicking" on the top row of the center divider will change
  2559.             the  tree  display to highlight (but not enter)   the  root
  2560.             directory.
  2561.  
  2562.          #8  - (UPPER CENTER DIVIDER)
  2563.  
  2564.             "Clicking"  in this area  of the center divider will scroll
  2565.             up the tree display one-half of the display screen.
  2566.  
  2567.          #9  - (LOWER CENTER DIVIDER)
  2568.  
  2569.             "Clicking"  in this area  of the center divider will scroll
  2570.             down the tree display one-half of the display screen.
  2571.  
  2572.          #10 - (BOTTOM CENTER DIVIDER)
  2573.  
  2574.             "Clicking"  on  the bottom  row of the center divider  will
  2575.             change  the tree display to  highlight (but not enter)  the
  2576.             last directory.
  2577.  
  2578.          #11 - (FILE BOX)
  2579.  
  2580.             "Clicking"  on a filename will toggle the "TAGGING" of that
  2581.             file.
  2582.  
  2583.             "Pressing" on one filename (start file) and "Releasing"  on
  2584.             a  different  filename (end file)  will toggle ALL  of  the
  2585.             files between the start and end files inclusive.
  2586.  
  2587.             "Double Clicking" on a filename (not the .ext) will execute
  2588.             the  specified  file (Keyboard "X"  command).   You  cannot
  2589.             specify command line parameters with this option.
  2590.  
  2591.             "Double  Clicking"  on a filename extension (including  the
  2592.             ".")   will  execute the specified file  (Keyboard  "Alt-X"
  2593.             command) overlaying the DS program to conserve memory.  You
  2594.             cannot specify command line parameters with this option.
  2595.  
  2596.             "Clicking"   in the columns where the Left and  Right  File
  2597.             Indicator  triangles  reside will toggle the "File  Follow"
  2598.             feature.    The  file  follow feature is defaulted  to  OFF
  2599.             whereby   moving  the  mouse  in  the  file  box  does  not
  2600.             automatically move the file indicator at the same time.  Be
  2601.             aware that when the file follow feature is  active  if  the
  2602.             user hits any of the arrow keys or the home or end keys the
  2603.             file follow feature  will  be deactivated  (ie: turned off)
  2604.             otherwise the user would be unable to change the  indicated
  2605.             file.
  2606.  
  2607.             "Pressing"  the Action Button ANYWHERE in the File Box WITH
  2608.  
  2609.  
  2610.                                     - 43 - 
  2611.  
  2612.  
  2613.  
  2614.             1 OR MORE FILES TAGGED  and  "Dragging and Releasing"   the
  2615.             mouse in the Available Drives area (#1),  or the  Directory
  2616.             Box  (#6),  or the  other  File Box (#11) of a split-screen
  2617.             display will initiate a "Copy/Move" popup window routine to
  2618.             either copy or move (default is copy)  tagged files to  the
  2619.             indicated drive or directory.
  2620.  
  2621.  
  2622.          #12 - (UPPER RIGHT BORDER)
  2623.  
  2624.             "Clicking"  in this area when an "up arrow"  appears in the
  2625.             top row will "page up"  the file listing to a previous page
  2626.             of files in the current directory.
  2627.  
  2628.          #13 - (LOWER RIGHT BORDER)
  2629.  
  2630.             "Clicking" in this area when an "down arrow" appears in the
  2631.             bottom  row will "page down"  the file listing to the  next
  2632.             page of files in the current directory.
  2633.  
  2634.          #14 - (LEFT BOTTOM BORDER)
  2635.  
  2636.             "Clicking"  is this area will TOGGLE the "Directory Follow"
  2637.             feature.   The directory follow feature is defaulted to  ON
  2638.             (except for DESQ) whereby moving the mouse in the directory
  2639.             box  with  the Action Button depressed  will  automatically
  2640.             move the directory highlighter at the same time.
  2641.  
  2642.          #15 - (RIGHT BOTTOM BORDER)
  2643.  
  2644.             "Clicking" in this area will toggle the split screen mode.
  2645.  
  2646.          #16 - (TAGGED TOTAL AREA)
  2647.  
  2648.             "Clicking" in this area will toggle the "Tags" on ALL files
  2649.             in the current directory.
  2650.  
  2651.  
  2652.  
  2653.          MOUSE "OPTION BUTTON" - POPUP MENUS
  2654.  
  2655.            Popup Menu - Main Options
  2656.            (Selected by "Clicking" the "OPTION/ESC Button")
  2657.  
  2658.           ┌──────────────────────────────────────────────────────────┐
  2659.           │File │ Tags │ DOS │ Setup │ Macros │ Tree │ Help │ Quit   │
  2660.           └──────────────────────────────────────────────────────────┘
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.                                     - 44 - 
  2669.  
  2670.  
  2671.  
  2672.            SubOption Selections
  2673.            (Selected by "Clicking" the "ACTION Button")
  2674.  
  2675.                 File                Setup                 Tree
  2676.           ┌───┴──────┴───┐    ┌───┴───────┴───┐    ┌────┴──────┴─────┐
  2677.           │     Edit     │    │Screen Repaint │    │      Menu       │
  2678.           │ Edit (Ovly)  │    │               │    │                 │
  2679.           │              │    │ 25 43/50 Line │    │  Add Directory  │
  2680.           │     List     │    │               │    │   Change Name   │
  2681.           │ List (Ovly)  │    │Program Limits │    │                 │
  2682.           │              │    │               │    │ Delete Directory│
  2683.           │   Execute    │    │    Mouse      │    │                 │
  2684.           │Execute (Ovly)│    │               │    │ Mount Directory │
  2685.           │              │    │    Colors     │    │UnMount Directory│
  2686.           │    Print     │    │               │    │                 │
  2687.           │ Print (Ovly) │    │Volume Show Tog│    │ Show/Switch Log │
  2688.           │              │    │               │    │  Write New Log  │
  2689.           │    Delete    │    │   Defaults    │    │                 │
  2690.           │              │    │               │    │   Rescan Tree   │
  2691.           │     Copy     │    │  EMM Summary  │    └─────────────────┘
  2692.           │     Move     │    │ Drive Summary │
  2693.           │    Rename    │    │               │
  2694.           │              │    │   About DS    │
  2695.           │     Find     │    │  Show Owner   │
  2696.           │ Select & Sort│    │Check Integrity│
  2697.           │  Attributes  │    └───────────────┘
  2698.           └──────────────┘
  2699.  
  2700.            SubOption Selections (cont)
  2701.            (Selected by "Clicking" the "ACTION Button")
  2702.  
  2703.                Tags             DOS             Macros          Help
  2704.           ┌──┴──────┴──┐    ┌─┴─────┴──┐    ┌─┴────────┴┐    ┌┴──────┴┐
  2705.           │  Tag All   │    │   DOS    │    │  Alt Fn   │    │Keyboard│
  2706.           │ UnTag All  │    │DOS (Ovly)│    │  Shft Fn  │    │ Mouse  │
  2707.           │Control Tags│    └──────────┘    │  Ctrl Fn  │    │Expanded│
  2708.           └────────────┘                    │  # Links  │    └────────┘
  2709.                                             │Alt # Links│
  2710.                                             └───────────┘
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.                                    - 45 - 
  2727.